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

Was this helpful?

  1. api reference
  2. Products
  3. Auto

MyCoverGenius

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

PreviousLeadwayNextSovereign Trust

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 Mini Comprehensive

Use this end-point to buy third party plus auto insurance from MyCovergenius.

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

Request Body

Name
Type
Description

vehicle_make*

string

This is the brand of the vehicle

vehicle_model*

string

This is the vehicle's model

address*

string

Customer's physical address

insurance_start_date*

string

This is the date your customer wants the plan to begin

gender*

string

Gender of customer

vehicle_registration_number*

string

Customer's vehicle registration number

engine_number*

string

Customer's vehicle chassis number

chassis_number*

string

Customer's vehicle chassis number

vehicle_insurance_type*

string

This is the type of insurance coverage the customer wants

vehicle_year_manufactured*

string

The year customer's vehicle was manufactured

vehicle_type*

string

Customer's vehicle type

vehicle_color*

string

Colour of customer's vehicle

vehicle_value*

number

The cost of customer's vehicle

first_name*

string

Customer's legal first name

last_name*

string

Customer's legal last name

email*

string

Customer's email address

dob*

string

Customer's date of birth as it appears on legal documents

phone*

string

Customer's phone number

product_id*

string

This is the ID of the insurance plan.

other_names*

string

Customer's middle name

owner_title*

string

The title of vehicle owner

occupation*

string

Job title of customer

town*

string

Customer's town of residence

state*

string

Customer's state of residence

national_id_image*

string

The image URL of customer's ID

{
   "responseCode":1,
   "responseText":"Purchase Successful",
   "data":{
      "policy":{
         "first_name":"John",
         "last_name":"Hall",
         "email":"xumesib@mailinator.com",
         "phone":"+1 (259) 132-8489",
         "dob":"2004-03-10",
         "customer_id":"3a983597-31d3-44ff-aa62-71d255015b92",
         "buyer_id":"3a983597-31d3-44ff-aa62-71d255015b92",
         "product_id":"0ced01f3-7698-4101-a244-dd5d70e974c4",
         "product_category_id":"978ced0d-0e05-4de6-b43a-b408c0e8b95e",
         "distributor_id":"76d5970a-d46b-43df-beb3-8f3117b7a60f",
         "provider_id":"0ef7f726-19e1-438c-87aa-574ca1718726",
         "activation_date":"2022-03-10",
         "start_date":"2022-03-10",
         "expiration_date":null,
         "meta":{
            "vehicle_registration_number":"akd345gh",
            "requestData":{
               "first_name":"John",
               "last_name":"Hall",
               "other_names":"Uta Mosley",
               "dob":"2004-03-10",
               "email":"xumesib@mailinator.com",
               "phone":"+1 (259) 132-8489",
               "gender":"male",
               "owner_title":"Chief",
               "occupation":"Quo modi nulla sint",
               "address":"Est eaque commodi d",
               "town":"Sequi impedit saepe",
               "state":"Dolor magni in ut ma",
               "product_id":4,
               "vehicle_value":3500000,
               "vehicle_color":"White",
               "vehicle_manufacturer":"indian",
               "vehicle_model":"chief vintage",
               "vehicle_insurance_type_id":1,
               "vehicle_type_id":4,
               "vehicle_reg_number":"akd345gh",
               "vehicle_year_manufactured":"2012",
               "vehicle_engine_chassis":"55SWF4JB0FU04735",
               "vehicle_engine_number":"55SWF4JB0FU04735",
               "policy_start_date":"2022-03-10",
               "national_id_image":"https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/464d0f7d-8115-4c39-b857-4f7825b9da28-john_hall_1646833630818_screenshot-2021-08-16-at-3.58.28-pm.png",
               "with_inspection":true
            }
         },
         "active":true,
         "genius_price":"10000.00",
         "market_price":"10000.00",
         "profit":2000,
         "purchase_id":"7aab6e2f-6d98-4c18-9ef7-752f60512611",
         "submitted_to_provider":false,
         "id":"769d28d9-2687-4aa9-b668-369e69ecc650",
         "created_at":"2022-03-09T12:47:14.414Z",
         "updated_at":"2022-03-09T12:47:14.414Z"
      }
   }
}
Sample Request Payload
{
  "vehicle_make": "1",
  "vehicle_model": "218",
  "other_names": "benjamin",
  "owner_title": "Mr",
  "gender": "Male",
  "occupation": "Engineer",
  "town": "ojo",
  "state": "Lagos",
  "vehicle_value": 3000000,
  "vehicle_color": "BlACK",
  "vehicle_insurance_type": "Private",
  "vehicle_type": "Suv",
  "vehicle_year_manufactured": "2018",
  "national_id_image": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/93311701-ed2c-4daf-aeb4-4f0c22f89e22-tamekah_dunn_1647604247647_screenshot-2021-08-16-at-3.58.28-pm.png",
  "address": "4 close festac town",
  "vehicle_registration_number": "akd344gf",
  "insurance_start_date": "2022-12-08",
  "engine_number": "3MZ7159738",
  "chassis_number": "5TDZA23C96S400120",
  "first_name": "Emeka",
  "last_name": "Okafor",
  "email": "emmy.okafor@gmail.com",
  "dob": "1991-04-14",
  "phone": "07064378577",
  "product_id": "0ced01f3-7698-4101-a244-dd5d70e974c4"
}

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

📦
🚘
Auxiliary
Auxiliary
Auxiliary