OTHER APIs

    API Endpoint

        https://test.bima.om/
                

RECENT REQUESTS


                    Response:


   
{
    "statusCode": "OK",
    "statusMessage": null,
    "Data": [
        {
            "EntityCode": "Insurance",
            "ProviderID": 10016,
            "RequestID": 4463702,
            "ReferenceNo": "F896B91B-B5D9-4E61-93B4-75B70A0EC8E5",
            "ServiceCode": "THIRD_PARTY",
            "ServiceName": "Third Party",
            "ProviderName": "Oman Qatar Insurance",
            "PolicyStatus": "Pending",
            "PolicyDateFrom": "2024-12-07T00:00:00",
            "PolicyDateTo": "2025-12-06T00:00:00",
            "AttributeText1": "R Y",
            "AttributeText2": "2731",
            "AttributeText3": "4 WHEEL DRIVE",
            "AttributeText4": "TUCSON",
            "AttributeText5": "HYUNDAI",
            "IconUrl": "https://bima.om//img/icons/m/THIRD_PARTY.png",
            "ImageURLThumbnail": "https://bima.om///img/Vehicles/10/201004/2016/cd777c3c-1e68-409b-a3e2-b8037ba4e0d6.jpg?v=1,https://bima.om///img/Vehicles/10/201004/2016/0d7d9616-fbd0-4da8-82a7-491d72faa30e.jpg?v=1",
            "RenewalStatusCode": null,
            "JobStatusCode": "",
            "step_code": "working_on_it",
            "step_title": "Working on it ",
            "step_sub_title": "Shortly our customer representative will get in touch with you.",
            "step_ImageURLThumbnail": "https://bima.om//img/icons/m/active/waiting_documents.gif?v=1"
        },
        {
            "EntityCode": "Insurance",
            "ProviderID": 10023,
            "RequestID": 4463701,
            "ReferenceNo": "CC266B33-F6B9-47E3-AE71-4957E112A04F",
            "ServiceCode": "THIRD_PARTY",
            "ServiceName": "Third Party",
            "ProviderName": "Muscat Insurance",
            "PolicyStatus": "Pending",
            "PolicyDateFrom": "2024-12-07T00:00:00",
            "PolicyDateTo": "2025-12-06T00:00:00",
            "AttributeText1": "R Y",
            "AttributeText2": "2731",
            "AttributeText3": "4 WHEEL DRIVE",
            "AttributeText4": "TUCSON",
            "AttributeText5": "HYUNDAI",
            "IconUrl": "https://bima.om//img/icons/m/THIRD_PARTY.png",
            "ImageURLThumbnail": "https://bima.om///img/Vehicles/10/201004/2016/cd777c3c-1e68-409b-a3e2-b8037ba4e0d6.jpg?v=1,https://bima.om///img/Vehicles/10/201004/2016/0d7d9616-fbd0-4da8-82a7-491d72faa30e.jpg?v=1",
            "RenewalStatusCode": null,
            "JobStatusCode": "",
            "step_code": "working_on_it",
            "step_title": "Working on it ",
            "step_sub_title": "Shortly our customer representative will get in touch with you.",
            "step_ImageURLThumbnail": "https://bima.om//img/icons/m/active/waiting_documents.gif?v=1"
        } 
    ]
}



Use this API to get customer recent requests, specify customer contact number including country code and language code
GET: /api/Insurance/GetCustomerRecentRequests?contactNo=96895542930&langCode=en

REQUEST DETAILS


                    Response:


   
{
    "thumbnail": [
        "https://bima.om/\\img\\Vehicles\\10\\201004\\2016\\cd777c3c-1e68-409b-a3e2-b8037ba4e0d6.jpg",
        "https://bima.om/\\img\\Vehicles\\10\\201004\\2016\\0d7d9616-fbd0-4da8-82a7-491d72faa30e.jpg"
    ],
    "policy_from": null,
    "policy_to": null,
    "issue_date": null,
    "entity_code": "Insurance",
    "prvider_name": "Oman Qatar Insurance",
    "policy_no": "",
    "contact_no_road_side_assistance": "80009111",
    "road_side_assistance_html": "
html content
", "policy_status": "Pending", "data": [ { "title": "Owner Name", "value": "Mohammad Ali Al Badi" }, { "title": "License ID", "value": "99086408" }, { "title": "Vehicle", "value": "R Y / 2731" }, { "title": "Model", "value": "HYUNDAI / TUCSON" }, { "title": "Insurance Type", "value": "Third Party" }, { "title": "Provider name", "value": "Oman Qatar Insurance" }, { "title": "Date From", "value": "07/12/2024" }, { "title": "Date To", "value": "06/12/2025" } ], "additional_drivers": [ { "id": "1984792", "first_name": "", "last_name": "Jabbar", "age": "50" }, { "id": "1984793", "first_name": "Nadir Sali", "last_name": "Al Naimi", "age": "20" } ], "travelers": null, "covers": [ { "Title": "Driver & Family", "Subtitle": "Personal Accident Benefit Cover", "Code": "PAB" }, { "Title": "Bima Car Replacement", "Subtitle": "3 days", "Code": "CAR_REPLACEMENT" } ], "follow_up": [ { "message": "Payment processed successfully\r\n", "date_time": "07/04/2024 13:42" } ], "documents_required": [ { "order_no": 18.000, "doc_type_code": "LicenseFront", "doc_type": "License front side", "icon_url": "" }, { "order_no": 19.000, "doc_type_code": "LicenseBack", "doc_type": "License back side", "icon_url": "" }, { "order_no": 20.000, "doc_type_code": "MulkiyaBack", "doc_type": "Mulkia back side", "icon_url": "" }, { "order_no": 21.000, "doc_type_code": "MulkiyaFront", "doc_type": "Mulkia front side", "icon_url": "" } ], "status_code": "OK", "status_message": null, "step_code": "working_on_it", "step_title": "Working on it ", "step_sub_title": "Shortly our customer representative will get in touch with you.", "step_ImageURLThumbnail": "https://bima.om/img/icons/m/active/waiting_documents.gif?v=1", "attribute_text1": "R Y", "attribute_text2": "2731", "attribute_text3": "4 WHEEL DRIVE", "attribute_text4": "TUCSON", "attribute_text5": "HYUNDAI", "attribute_no1": 0, "attribute_no2": 0 }

To get details of paid requests, use below API.
GET: /api/Insurance/GetPolicyDetails?id=4463702&langcode=en

The response is including, request status, request details (dictionary data), additional drivers, travelers, covers, follow-up comments, documents required and images for request if available.

REQUEST PARAMETERS

Field Type Limit Required Description
ID long Yes Unique request id received in API response (GetCustomerRecentRequests)
contactNo String min 11, max 15 chars Yes The Customer Contact Number including Country Code
langCode String 2 Chars Yes language code

POLICY DOCUMENTS


    Response :

   {
    "data": [
        {
            "EntityCode": "Insurance",
            "SharedCode": "7DFC82FD-0A5D-42EB-964B-B5EBA4A80BF6",
            "RefID": "CC266B33-F6B9-47E3-AE71-4957E112A04F",
            "FileName": "stamp-ico.jpeg",
            "FileContentType": "image/jpeg",
            "ThumbnailURL": "/Uploads/thumb/2024\\ef97192e-9724-4a47-a431-831e080c1f7a.jpg",
            "FileExtension": ".jpeg",
            "FileSize": 7260,
            "FileSizeDisplay": "7.1KB",
            "DocType": "Policy Document"
        },
        {
            "EntityCode": "Insurance",
            "SharedCode": "70DBBF2A-ABEC-470D-9CF2-3AFAB2074AE1",
            "RefID": "CC266B33-F6B9-47E3-AE71-4957E112A04F",
            "FileName": "Car Replacement By Bima.pdf",
            "FileContentType": "application/pdf",
            "ThumbnailURL": "/img/icons/Ext/pdf.png",
            "FileExtension": ".pdf",
            "FileSize": 384288,
            "FileSizeDisplay": "375.3KB",
            "DocType": "Car Replacement"
        }
    ],
    "statusCode": "OK",
    "statusMessage": null
}


You can get list of policy documents for completed requests. Use below API to read available documents GET: /api/Document/GetSharedDocuments/?entityCode=Insurance&refID=CC266B33-F6B9-47E3-AE71-4957E112A04F

REQUEST PARAMETERS

Field Type Limit Required Description
quotation_id String Yes Quotation unique reference
entityCode String Yes Available in API response (GetCustomerRecentRequests)

DOWNLOAD DOCUMENT

To download a policy document, use below API.
/Document/SharedDownload?id=7DFC82FD-0A5D-42EB-964B-B5EBA4A80BF6&refID=CC266B33-F6B9-47E3-AE71-4957E112A04F

REQUEST PARAMETERS

Field Type Description
id String Yes The SharedCode is available in API response
refID String Yes Quotation unique reference