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

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

201: Created

{
   "responseCode":1,
   "responseText":"Purchase Successful",
   "data":{
      "policy":{
         "first_name":"John",
         "last_name":"Hall",
         "email":"[e-mail]",
         "phone":"[phone]",
         "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":"[e-mail]",
               "phone":"[phone]",
               "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": "[e-mail]",
  "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