Skip to main content
POST
Request quotes

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme

Headers

Accept-Language
enum<string>

Set to ar to receive Arabic-localized quote content.

Available options:
ar
Example:

"ar"

Body

application/json
otp
string
required

The OTP received by the customer from the Request OTP API

Example:

"123456"

owner_id
string
required

Owner ID must be 10 digits starting with 1, 2, or 7

Pattern: ^(1|2|7)\d{9}$
phone
string
required

Phone number must start with 05 and be 10 digits

Pattern: ^05\d{8}$
birthdate
string<date>
required

Birthdate in YYYY-MM-DD format

car_estimated_cost
number
required

Estimated cost of the car

email
string<email>

Email address must be valid and belongs to the customer

car_sequence_number
string

Car sequence number must be 8 or 9 digits

Pattern: ^\d{8,9}$
custom_number
string

Custom car number between 1000000 and 9999999999 (for newly imported cars)

Pattern: ^[1-9]\d{6,9}$
is_ownership_transfer
boolean
default:false

Indicates if the ownership is being transferred

current_car_owner_id
string

Required if is_ownership_transfer is true; 10 digits starting with 1,2,7

Pattern: ^(1|2|7)\d{9}$
car_model_year
integer

Car model year between 1950 and next year

Required range: 1950 <= x <= 2026
start_date
string<date>

Desired policy start date in YYYY-MM-DD. Must be between tomorrow and 28 days from today (inclusive). The platform validates this range server-side.

Example:

"2025-12-11"

drivers
object[]

List of drivers for the vehicle. When provided, the sum of all driving_percentage values must equal 100, and the owner must be included among the drivers.

Example:

Response

Insurance quote details

owner_id
integer

The owner’s national ID or Iqama ID

phone
string

The owner's phone number

birthdate
string<date>

The owner's birthdate. Hijri for Saudi nationals, Gregorian for others

car_sequence_number
integer

The car sequence number from 9 digits

custom_number
string

Custom car number for newly imported cars (present when custom_number was used in the request)

is_ownership_transfer
boolean

Whether it was a car transfer or not

car_estimated_cost
number

The estimated cost of the car

car_model_year
integer

The car model year

start_date
string<date>

Requested policy start date in YYYY-MM-DD. Returned if provided in the quote request.

drivers
object[]

List of drivers associated with this quote request. Returned if drivers were provided in the request.

quotes
object[]

An array representing each insurance company quote. Each item has the company name, the prices, and the benefits.

client_id
string<uuid>

Your own client ID

updated_at
string<date-time>

In case of an update on this quote, this date will change

created_at
string<date-time>

When was the quote requested

id
integer

Yasmina ID for the quote. You can use it to delete items or showing it again to the customer