Its required to pass all the required inputs/data for customer and License details.
To submit a quotation you need to make a POST call to the following url:
POST/v1/Quotation/Submit
| Field | Type | Limit | Required | Description |
| quotation_id | string | 500 | Yes | Quotation Id (encrypted) |
| offer_id | string | 20 | Conditional | Selected offer's id. Send exactly one of offer_id / offer_group_id |
| offer_group_id | string | 20 | Conditional | Selected group offer's id (offers covering several insured persons) |
| lang_code | string | 2 | Yes | Request language: en, ar |
| policy_no_previous | string | 50 | Optional | Previous policy number, if any |
| schedule |
Policy start
object
| Field | Type | Limit | Required | Description |
| date_from | string | 10 | Optional | Policy start date, dd/MM/yyyy. Default: today |
|
| customer |
Customer
object
| Field | Type | Limit | Required | Description |
| id_no | string | 20 | Yes | Customer civil / resident ID number |
| id_type | int | - | Yes | 1 = Person, 2 = Company |
| id_expire_date | string | 10 | Optional | ID expiry date, dd/MM/yyyy |
| title_id | int | - | Yes | From the titles lookup |
| first_name | string | 25 | Yes | First name |
| middle_name | string | 25 | Optional | Middle name |
| last_name | string | 25 | Yes | Last name |
| email | string | 50 | Yes | Policy documents are sent to it |
| dob | string | 10 | Yes | Date of birth, dd/MM/yyyy |
| gender_id | int | - | Yes | 1 = Male, 2 = Female |
| nationality_country_id | int | - | Optional | From the nationalities lookup |
| region_id, city_id, town_id | Int64 | - | Yes | From the regions and cities lookup |
| pobox_no | string | 10 | Optional | P.O. Box number |
| address | string | 30 | Yes | Address |
| address2 | string | 30 | Optional | Address line 2 |
| contact_full_no | string | 20 | Conditional | The quotation's contact number; required when documents are sent |
|
| malpractice |
Medical malpractice
object
| Field | Type | Limit | Required | Description |
| clinic_name | string | 50 | Yes | Hospital / clinic name |
| is_currently_insured | boolean | - | Yes | Has a currently active malpractice policy |
| prev_company_id | Int64 | - | Conditional | Current insurer, when currently insured |
| prev_claim_limit | number | - | Conditional | Current policy claim limit, when currently insured |
| prev_aggregate_limit | number | - | Conditional | Current policy aggregate limit, when currently insured |
| prev_retro_active_date | string | 10 | Conditional | Retroactive date, dd/MM/yyyy, when currently insured |
| prev_policy_date_from | string | 10 | Conditional | Current policy start date, dd/MM/yyyy, when currently insured |
| prev_policy_date_to | string | 10 | Conditional | Current policy end date, dd/MM/yyyy, when currently insured |
| prev_has_any_claim | string | 50 | Conditional | Describe previous claims, if any |
| prev_aggregate_cost | number | - | Conditional | Aggregate cost of previous claims, if any |
|
| documents |
Files for the required documents, one item per document type. Empty array when none
array
| Field | Type | Limit | Required | Description |
| doc_type_id | Int64 | - | Yes | Document type from RequiredDocuments, e.g. 67 |
| ref_id_sub | Int64 | - | Optional | 0 |
| file_name | string | 100 | Yes | File name with extension, e.g. license-front.jpg |
| data_base64string | string | 5 MB | Conditional | File content in base64 without the data: prefix. Send this or file_url |
| file_url | string | 500 | Conditional | Full http(s) URL of the file. Send this or data_base64string |
|
| question_answers |
Answers to the offer's questions. Empty array when none
array
| Field | Type | Limit | Required | Description |
| question_id | Int64 | - | Yes | Question unique id |
| option_id | Int64 | - | Conditional | Selected option id for choice questions; otherwise 0 |
| answer | string | 50 | Yes | Answer value |
| input_detils | string | 500 | Optional | Additional input details if required |
|
{
"quotation_id": "{{QUOTATION_ID}}",
"offer_id": "38501",
"lang_code": "en",
"policy_no_previous": "",
"customer": {
"id_no": "",
"id_type": 1,
"id_expire_date": "",
"license_no": "",
"country_code": "968",
"area_code": "",
"subscriber_code": "",
"national_no": "",
"contact_full_no": "",
"title_id": 0,
"first_name": "Ali",
"middle_name": "",
"last_name": "Ahmed",
"email": "aa@hotmail.com",
"nationality_country_id": 0,
"nationality_country_code": "",
"nationality_country_name": "",
"residence_country_id": 0,
"dob": "",
"passport_no": "",
"gender_id": 0,
"gender_name": "",
"region_id": 0,
"region_name": "",
"city_id": 0,
"city_name": "",
"town_id": 0,
"pobox_no": "123",
"address": "Al Ansab",
"address2": "Muscat, Sultanate of Oman"
},
"schedule": {
"policy_term_id": 2,
"date_from": "05/03/2026",
"date_to": null
},
"malpractice": {
"qualification_id": 0,
"profession_as_per_license": "Dentist",
"licensing_authority_id": 0,
"license_no": "",
"policy_term_id": 0,
"claim_limit": 0.0,
"aggregate_limit": 0.0,
"clinic_name": "Al Faiz Hospital",
"is_currently_insured": true,
"prev_company_id": 123,
"prev_claim_limit": 0.0,
"prev_aggregate_limit": 0.0,
"prev_retro_active_date": "09/02/2026",
"prev_policy_date_from": "",
"prev_policy_date_to": "",
"prev_has_any_claim": "",
"prev_aggregate_cost": 0.0
},
"documents": [
{
"doc_type_id": 1,
"ref_id_sub": 7,
"file_name": "bima-en.png",
"file_url": "",
"data_base64string": "",
"form_file": null
},
{
"doc_type_id": 2,
"ref_id_sub": 6,
"file_name": "bima-en.png",
"file_url": "",
"data_base64string": "",
"form_file": null
}
],
"question_answers": [
{
"question_id": 41,
"option_id": 0,
"answer": "University of Sciences and Technology",
"input_detils": " "
},
{
"question_id": 42,
"option_id": 0,
"answer": "KIMS Hospital Muscat Oman",
"input_detils": " "
},
{
"question_id": 43,
"option_id": 0,
"answer": "no",
"input_detils": " "
},
{
"question_id": 44,
"option_id": 0,
"answer": "yes",
"input_detils": "Was declined because of requested of high claim limit"
},
{
"question_id": 45,
"option_id": 0,
"answer": "no",
"input_detils": " "
},
{
"question_id": 46,
"option_id": 0,
"answer": "no",
"input_detils": " "
},
{
"question_id": 47,
"option_id": 0,
"answer": "no",
"input_detils": " "
}
],
"request_items": []
}