mycover.ai
  • Home
  • Distributor
  • 🚀Getting Started
    • Quickstart
    • Environments
    • Authentication
    • Testing
    • Errors
    • Go Live Checklist
    • FAQs
  • 🔌Libraries & SDKs
    • Javascript
    • Vue 2
    • Vue 3
    • React
    • Flutter
    • Android
    • React Native
    • iOS
  • 📦api reference
    • Products
      • 🚘Auto
        • Aiico
        • Leadway
        • MyCoverGenius
        • Sovereign Trust
        • Coronation
        • Tangerine
        • Sanlam
      • ♥️Health
        • Hygeia
          • Hyprime Insurance
          • Hybasic Insurance
        • Bastion
          • Bastion Health
          • MediSure
        • Malaria Cover
      • 💞Personal Accident Cover
        • Aiico
        • Leadway
        • Sanlam
      • 🏠Content (Home/Office)
        • Aiico
        • Coronation
        • Sanlam
      • ✈️Travel
        • Allianz
        • Aiico
      • 💵Life Insurance
        • Credit Life
        • SME Flex
        • Flex Life
      • 🚚Goods In Transit
        • Goods In Transit (GIT)
        • Goods In Transit (GIT) On-demand
      • 💻Gadget
        • Sovereign Trust Insurance
        • Coronation
        • Tangerine
      • 🛳️Marine Insurance ✨
        • MyCoverGenius Import Marine Cover
        • Marine Cover
    • Policies
    • Claims
      • Credit Life
    • Wallet
    • Transactions
    • Customers
    • Auxiliary
      • Products
        • Bulk Purchase
  • 🧳Services
    • Webhooks
      • Validation
      • Purchase Webhook
      • Renewal Webhook
    • Messaging
Powered by GitBook
On this page
  • Buy Coronation Comprehensive Auto Insurance
  • Buy Coronation Third-party Auto Insurance

Was this helpful?

  1. api reference
  2. Products
  3. Auto

Coronation

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

PreviousSovereign TrustNextTangerine

Last updated 1 year ago

Was this helpful?

Certain properties obtain their values from supplementary endpoints. Refer to the 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']

{
    "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": "kenjimmy77717@gmail.com",
            "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": "bty.kenjimmy77717@gmail.com",
                            "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": "kenjimmy77717@gmail.com",
    "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']

{
    "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": "kenjimmy77717@gmail.com",
            "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": "bty.kenjimmy77717@gmail.com",
                            "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": "kenjimmy77717@gmail.com",
    "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 page for a list of these additional endpoints.

📦
🚘
Auxiliary
Auxiliary
Auxiliary