| Field | Type | Limit | Required | Description |
| request_type_code | string | 50 | Yes | Quotation request type: MOTOR_PRIVATE_INSURANCE |
| insurance_type_code | string | 50 | Yes | Insurance type: MOTOR_THIRD_PARTY, MOTOR_COMPREHENSIVE (same value as vehicles[].insurance_type) |
| voucher_code | string | 50 | Optional | Voucher or promo code |
| policy_no_previous | string | 50 | Optional | Previous policy number, if any |
| lang_code | string | 2 | Optional | Request language: en, ar. Default: en |
| async | boolean | - | Optional | true: create the quotation and return at once, read offers later. false: return the offers in the response. Recommended: true |
| include_data | boolean | - | Optional | Response includes additional data |
| include_result | boolean | - | Optional | Response includes offers |
| client_type_id | int | - | Optional | Website: 1, Mobile: 2, Kiosk: 3 |
| collector_track_id | string | 50 | Optional | Your own unique reference for this request |
| reference_by_id | Int64 | - | Optional | Bima customer id when the customer is logged in; otherwise 0 |
| os | string | 50 | Optional | Device operating system name, version |
| browser | string | 50 | Optional | Device browser name, version |
| schedule |
Policy period
object
| Field | Type | Limit | Required | Description |
| policy_term_id | Int64 | - | Optional | Policy term; default: the product's term |
| date_from | string | 10 | Optional | Policy start date, dd/MM/yyyy |
| date_to | string | 10 | Optional | Policy end date, dd/MM/yyyy |
|
| customer |
Customer (vehicle owner)
object
| Field | Type | Limit | Required | Description |
| country_code | string | 5 | Yes | Mobile dial code without +, e.g. 968 |
| national_no | string | 15 | Yes | Mobile number without the dial code. Oman: exactly 8 digits |
| contact_full_no | string | 20 | Yes | country_code + national_no, e.g. 96895542930 |
| area_code | string | 3 | Optional | Calculated from contact_full_no when empty |
| subscriber_code | string | 15 | Optional | Calculated from contact_full_no when empty |
| id_no | string | 10 | Yes | Vehicle owner's driving licence number, digits only. Same value as license_no |
| license_no | string | 10 | Yes | Vehicle owner's driving licence number, digits only |
| id_type | int | - | Fixed | 1 |
| title_id | int | - | Fixed | 1 |
| first_name | string | 25 | Optional | Send ""; names are sent later |
| middle_name | string | 25 | Optional | Send "" |
| last_name | string | 25 | Optional | Send "" |
| email | string | 50 | Optional | Contact email |
| dob | string | 10 | Optional | Date of birth, dd/MM/yyyy |
| gender_id | int | - | Fixed | 1 |
| nationality_country_id | int | - | Optional | From the nationalities lookup |
| city_id | Int64 | - | Fixed | 52 |
| region_id, town_id | Int64 | - | Optional | Send 0 |
| pobox_no | string | 10 | Optional | P.O. Box number |
| address | string | 30 | Optional | Address |
| address2 | string | 30 | Optional | Address line 2 |
|
| vehicles |
Vehicles array (one vehicle per quotation)
array
| Field | Type | Limit | Required | Description |
| id | Int64 | - | Optional | 0 for a new vehicle |
| insurance_type | string | 50 | Yes | MOTOR_THIRD_PARTY or MOTOR_COMPREHENSIVE (same as insurance_type_code) |
| vehicle_no | string | 6 | Yes | Plate number, digits only. New vehicle: "0" |
| vehicle_code | string | 5 | Yes | Plate code from the plate-code list. New vehicle: "T B A" |
| vehicle_value | number | 1-999999 | Conditional | Comprehensive: market value in whole OMR, required. Third party: not used, send 1 |
| renewal_request | boolean | - | Fixed | true |
| transfer_request | boolean | - | Optional | true when the vehicle is being transferred to a new owner (renew in the new owner's name). Never together with new_plate_request |
| new_plate_request | boolean | - | Optional | true for a new vehicle not yet registered with ROP (bought new from an agency or imported). Needs chassis_no |
| chassis_no | string | 20 | Conditional | New vehicle only: letters/digits, upper case. Otherwise "" |
|
{
"request_type_code": "MOTOR_PRIVATE_INSURANCE",
"insurance_type_code": "MOTOR_THIRD_PARTY",
"voucher_code": "",
"lang_code": "en",
"include_data": false,
"include_result": true,
"async": true,
"customer": {
"id_no": "99086408",
"id_type": 1,
"id_expire_date": "",
"license_no": "99086408",
"country_code": "968",
"area_code": "",
"subscriber_code": "",
"national_no": "95542930",
"contact_full_no": "96895542930",
"title_id": 1,
"first_name": "",
"middle_name": "",
"last_name": "",
"email": "",
"nationality_country_id": 0,
"residence_country_id": 0,
"dob": "",
"passport_no": "",
"gender_id": 1,
"region_id": 0,
"city_id": 52,
"town_id": 0,
"pobox_no": "",
"address": "",
"address2": ""
},
"vehicles": [
{
"id": 0,
"insurance_type": "MOTOR_THIRD_PARTY",
"vehicle_no": "97337",
"vehicle_code": "H",
"vehicle_value": 1,
"renewal_request": true,
"transfer_request": false,
"new_plate_request": false,
"chassis_no": ""
}
],
"client_type_id": 1,
"reference_by_id": 0,
"os": "Windows",
"browser": "Chrome"
}
{
"status_code": "200",
"status_message": "Quotation retrieved successfully",
"data": {
"quotation_no": "26100291362",
"quotation_id": "dldTUytwK0tReHpW...",
"status_code": "Processing",
"status_title": "Processing",
"messages": []
},
"messages": []
}