Coronation

Connect any or all of the following endpoints to buy and manage auto-products from Coronation.

Certain properties obtain their values from supplementary endpoints. Refer to the Auxiliary page for a list of these additional endpoints.

Buy Coronation Comprehensive Auto Insurance

Connect this endpoint to buy comprehensive auto-products from Coronation

POST https://api.mycover.ai/v1/products/coronation/buy-comprehensive

Request Body

Name	Type	Description
vehicle_make*	String	The brand of the vehicle. Head over to the auxiliary section and GET /get-vehicle-make?provider=aiico
vehicle_model*	String	The model of the vehicle. Use this endpoint /products/aiico/get-vehicle-model.
address*	string	Your valid address
vehicle_color*	String	This vehicle colour. Head over to the auxiliary section and GET /color-list
registration_number*	String	Vehicle's plate number
engine_number*	String	The vehicle's engine number
chassis_number*	String	Chasis number of the vehicle
year_of_manufacture*	String	The vehicle manufacture year.
first_name*	string	Your first name
last_name*	string	Your last name
email*	string	Your valid email address
vehicle_insurance_type*	String	Is the vehicle private or commercial. Can be either of [Private Motor, Commercial Vehicle]
phone_number*	string	Your valid phone number
product_id*	String	This is the ID of the insurance plan.
gender*	String	Your gender. Can be one of [Male, Female]
date_of_birth*	String	Your date of birth
title*	String	Your personal title e.g Chief. Head over to the auxiliary section and GET titles.
state*	String	Your state of residence e.g Lagos State. Head over to the auxiliary section and GET states.
identification_name*	String	The type of ID provided. Head over to the auxiliary section and GET /identification-types.
identification_url*	String	The link to the id. Head over to the auxiliary section and POST /upload-file.
vehicle_cost*	Number	How much the vehicle was bought for.
vehicle_category	String	What type of vehicle is it? Can be one of ['Bus', 'Car', 'Jeep - Suv', 'Truck']

200: OK Success Response

{
    "responseCode": 1,
    "responseText": "Purchase Successful",
    "data": {
        "policy": {
            "id": "db9b5733-6d19-4b7e-9fca-3c41ab3a5fc3",
            "app_mode": "test",
            "active": true,
            "first_name": "Wale",
            "last_name": "Jameson",
            "email": "[e-mail]",
            "dob": "1996-03-11",
            "phone": "08034567891",
            "start_date": "2023-12-15T00:00:00.000Z",
            "expiration_date": "2024-12-14T00:00:00.000Z",
            "activation_date": "2023-12-15T00:00:00.000Z",
            "distributor_id": "10cd1dac-3a5c-43ee-b935-641d53f9cb27",
            "customer_id": "15b1d799-9127-4353-ad1c-04e76bb0e6eb",
            "buyer_id": "15b1d799-9127-4353-ad1c-04e76bb0e6eb",
            "product_id": "45140c74-fc6f-42f5-a0d2-66800b22d999",
            "product_category_id": "978ced0d-0e05-4de6-b43a-b408c0e8b95e",
            "provider_id": "63dbfce7-a743-47bd-bc49-b95703054aa1",
            "meta": {
                "payload": {
                    "ROOT": {
                        "TOKEN": null,
                        "STATUS": "",
                        "PRODUCT": "1001_IND",
                        "POLICYINFO": {
                            "COMMENT": "confirmed",
                            "END_DATE": "2024-12-14",
                            "COVER_CODE": "001",
                            "PREMIUM_LC": 75000,
                            "START_DATE": "2023-12-15",
                            "SUM_INSURED": 1500000,
                            "PRODUCT_CODE": "1001_IND",
                            "POLICY_STATUS": "approved",
                            "CONCLUSION_DATE": ""
                        },
                        "POLICYSTAGE": "PolicyCreation",
                        "VEHICLEINFO": {
                            "COLOR": "BLACK",
                            "VIN_NUMBER": "SV30-0169266",
                            "TYPE_OF_USE": "Private Motor",
                            "VEHICLE_MAKE": "Toyota",
                            "VEHICLE_TYPE": "Truck",
                            "ENGINE_NUMBER": "PJ12345U123456P",
                            "VEHICLE_MODEL": "Toyota TUNDRA",
                            "LICENSE_NUMBER": "ABC-123DE",
                            "PRODUCTION_YEAR": "2015"
                        },
                        "CUSTOMERINFO": {
                            "DOB": "1996-03-11",
                            "EMAIL": "[e-mail]",
                            "TITLE": "Chief",
                            "GENDER": "Male",
                            "SURNAME": "Jameson",
                            "FIRSTNAME": "Wale",
                            "TELEPHONE": "08034567891",
                            "POLICYHOLDER": "yes"
                        },
                        "POLICYSUBSTAGE": "INITIATE_POLICY_CREATION"
                    }
                },
                "policy_number": "OJ140962310161",
                "certificate_url": "https://wapicresourcefiles.blob.core.windows.net/2019/598655590_Certificate.pdf",
                "vehicle_registration_number": "ABC-123DE"
            },
            "genius_price": 75000,
            "market_price": 75000,
            "purchase_id": "f72c5662-1744-4efa-a013-180228f008bb",
            "profit": 15000,
            "submitted_to_provider": false,
            "updated_at": "2023-12-15T10:41:10.994Z",
            "created_at": "2023-12-15T10:40:53.116Z",
            "deleted_at": null,
            "inspection_id": null
        }
    }
}

Sample Request Payload

{
    "first_name": "Wale",
    "last_name": "Jameson",
    "phone_number": "08034567891",
    "email": "[e-mail]",
    "gender": "Male",
    "date_of_birth": "1996-03-11",
    "title": "Chief",
    "address": "32, Ajewole Street, Igando Road",
    "state": "Lagos",
    "identification_name": "Drivers License",
    "identification_url": "https://via.placeholder.com/300/09f/fff.png",
    "registration_number": "ABC-123DE",
    "engine_number": "PJ12345U123456P",
    "chassis_number": "SV30-0169266",
    "vehicle_make": "Toyota",
    "vehicle_model": "TUNDRA",
    "vehicle_color": "BLACK",
    "year_of_manufacture": "2015",
    "vehicle_insurance_type": "Private Motor",
    "vehicle_cost": 1500000,
    "vehicle_category": "Truck",
    "product_id": "45140c74-fc6f-42f5-a0d2-66800b22d999"
}

Buy Coronation Third-party Auto Insurance

Connect this endpoint to buy third-party auto-products from Coronation

POST https://api.mycover.ai/v1/products/coronation/buy-third_party

Request Body

Name	Type	Description
vehicle_make*	String	The brand of the vehicle. Head over to the auxiliary section and GET /get-vehicle-make?provider=aiico
vehicle_model*	String	The model of the vehicle. Use this endpoint /products/aiico/get-vehicle-model.
address*	string	Your valid address
vehicle_color*	String	This vehicle colour. Head over to the auxiliary section and GET /color-list
registration_number*	String	Vehicle's plate number
engine_number*	String	The vehicle's engine number
chassis_number*	String	Chasis number of the vehicle
year_of_manufacture*	String	The vehicle manufacture year.
first_name*	string	Your first name
last_name*	string	Your last name
email*	string	Your valid email address
vehicle_insurance_type*	String	Is the vehicle private or commercial. Can be either of [Private Motor, Commercial Vehicle]
phone_number*	string	Your valid phone number
product_id*	String	This is the ID of the insurance plan.
gender*	String	Your gender. Can be one of [Male, Female]
date_of_birth*	String	Your date of birth
title*	String	Your personal title e.g Chief. Head over to the auxiliary section and GET titles.
state*	String	Your state of residence e.g Lagos State. Head over to the auxiliary section and GET states.
identification_name*	String	The type of ID provided. Head over to the auxiliary section and GET /identification-types.
identification_url*	String	The link to the id. Head over to the auxiliary section and POST /upload-file.
vehicle_cost*	Number	How much the vehicle was bought for.
vehicle_category	String	What type of vehicle is it? Can be one of ['Bus', 'Car', 'Jeep - Suv', 'Truck']

200: OK Success Response

{
    "responseCode": 1,
    "responseText": "Purchase Successful",
    "data": {
        "policy": {
            "id": "db9b5733-6d19-4b7e-9fca-3c41ab3a5fc3",
            "app_mode": "test",
            "active": true,
            "first_name": "Wale",
            "last_name": "Jameson",
            "email": "[e-mail]",
            "dob": "1996-03-11",
            "phone": "08034567891",
            "start_date": "2023-12-15T00:00:00.000Z",
            "expiration_date": "2024-12-14T00:00:00.000Z",
            "activation_date": "2023-12-15T00:00:00.000Z",
            "distributor_id": "10cd1dac-3a5c-43ee-b935-641d53f9cb27",
            "customer_id": "15b1d799-9127-4353-ad1c-04e76bb0e6eb",
            "buyer_id": "15b1d799-9127-4353-ad1c-04e76bb0e6eb",
            "product_id": "45140c74-fc6f-42f5-a0d2-66800b22d999",
            "product_category_id": "978ced0d-0e05-4de6-b43a-b408c0e8b95e",
            "provider_id": "63dbfce7-a743-47bd-bc49-b95703054aa1",
            "meta": {
                "payload": {
                    "ROOT": {
                        "TOKEN": null,
                        "STATUS": "",
                        "PRODUCT": "1001_IND",
                        "POLICYINFO": {
                            "COMMENT": "confirmed",
                            "END_DATE": "2024-12-14",
                            "COVER_CODE": "001",
                            "PREMIUM_LC": 75000,
                            "START_DATE": "2023-12-15",
                            "SUM_INSURED": 1500000,
                            "PRODUCT_CODE": "1001_IND",
                            "POLICY_STATUS": "approved",
                            "CONCLUSION_DATE": ""
                        },
                        "POLICYSTAGE": "PolicyCreation",
                        "VEHICLEINFO": {
                            "COLOR": "BLACK",
                            "VIN_NUMBER": "SV30-0169266",
                            "TYPE_OF_USE": "Private Motor",
                            "VEHICLE_MAKE": "Toyota",
                            "VEHICLE_TYPE": "Truck",
                            "ENGINE_NUMBER": "PJ12345U123456P",
                            "VEHICLE_MODEL": "Toyota TUNDRA",
                            "LICENSE_NUMBER": "ABC-123DE",
                            "PRODUCTION_YEAR": "2015"
                        },
                        "CUSTOMERINFO": {
                            "DOB": "1996-03-11",
                            "EMAIL": "[e-mail]",
                            "TITLE": "Chief",
                            "GENDER": "Male",
                            "SURNAME": "Jameson",
                            "FIRSTNAME": "Wale",
                            "TELEPHONE": "08034567891",
                            "POLICYHOLDER": "yes"
                        },
                        "POLICYSUBSTAGE": "INITIATE_POLICY_CREATION"
                    }
                },
                "policy_number": "OJ140962310161",
                "certificate_url": "https://wapicresourcefiles.blob.core.windows.net/2019/598655590_Certificate.pdf",
                "vehicle_registration_number": "ABC-123DE"
            },
            "genius_price": 75000,
            "market_price": 75000,
            "purchase_id": "f72c5662-1744-4efa-a013-180228f008bb",
            "profit": 15000,
            "submitted_to_provider": false,
            "updated_at": "2023-12-15T10:41:10.994Z",
            "created_at": "2023-12-15T10:40:53.116Z",
            "deleted_at": null,
            "inspection_id": null
        }
    }
}

Sample Request Payload

{
    "first_name": "Wale",
    "last_name": "Jameson",
    "phone_number": "08034567891",
    "email": "[e-mail]",
    "gender": "Male",
    "date_of_birth": "1996-03-11",
    "title": "Chief",
    "address": "32, Ajewole Street, Igando Road",
    "state": "Lagos",
    "identification_name": "Drivers License",
    "identification_url": "https://via.placeholder.com/300/09f/fff.png",
    "registration_number": "ABB-123DE",
    "engine_number": "PJ32345U123456P",
    "chassis_number": "SV31-0169266",
    "vehicle_make": "Toyota",
    "vehicle_model": "TUNDRA",
    "vehicle_color": "BLACK",
    "year_of_manufacture": "2015",
    "vehicle_insurance_type": "Private Motor",
    "vehicle_cost": 1500000,
    "vehicle_category": "Truck",
    "product_id": "56240c74-fc6f-42f5-a0d2-66800b22d99a"
}

Certain properties obtain their values from supplementary endpoints. Refer to the Auxiliary page for a list of these additional endpoints.

Auxiliary