MyCoverGenius

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

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

NameTypeDescription

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 Auxiliary page for a list of these additional endpoints.

pageAuxiliary

Last updated