Aiico

Connect any or all of the following endpoints to buy and manage products from AIICO.

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

Buy Third-Party Auto

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

POST https://api.mycover.ai/v1/products/aiico/buy-third-party-auto

Request Body

Name	Type	Description
first_name*	string	Customer's legal first name
last_name*	string	Customer's legal last name
email*	string	Customer's email address
phone_number*	string	Customer's phone number
date_of_birth*	string	Customer's date of birth as it appears on legal documents
address*	string	Customer's physical address
state*	string	Customer's state of residence
product_id*	string	This is the ID of the insurance plan.
identification_name*	string	The name of the customer's identification type
identification_url*	string	The image URL of customer's ID
bvn*	string	Customer's BVN number. To verify customer's identity
registration_number*	string	Customer's vehicle plate number
vehicle_category*	string	The category of customer's vehicle
year_of_manufacture*	string	The year customer's vehicle was manufacture
title_id*	string	The title your customer is addressed by e.g. Mrs.
vehicle_cost*	number	Cost of customer's vehicle

401: Unauthorized Unauthorized Response

{
  "responseCode": 0,
  "responseText": "Unauthorized",
  "errorData": null,
  "data": {}
}

200: OK Success Response

{
   "responseCode":1,
   "responseText":"policy purchase successful",
   "data":{
      "id":"65b09302-26de-42b4-80d9-8b137130d3dd",
      "first_name":"Flynn",
      "last_name":"Knowles",
      "email":"[e-mail]",
      "phone":"[phone]",
      "dob":"2004-03-18",
      "customer_id":"5789b330-2077-496b-bcf9-e75152f2b925",
      "buyer_id":"5789b330-2077-496b-bcf9-e75152f2b925",
      "product_id":"a72c4e3c-e868-4782-bb35-df6e3344ae6c",
      "product_category_id":"978ced0d-0e05-4de6-b43a-b408c0e8b95e",
      "purchase_id":"a9e83085-bc1d-44a7-b974-f68066e72a8e",
      "distributor_id":"76d5970a-d46b-43df-beb3-8f3117b7a60f",
      "provider_id":"63dbfce7-a743-47bd-bc49-b95703054aa1",
      "activation_date":"01-Jan-0001",
      "start_date":"01-Jan-0001",
      "expiration_date":"01-Jan-0001",
      "market_price":5000,
      "genius_price":5000,
      "profit":1000,
      "meta":{
         "vehicle_registration_number":"akd223gf",
         "policy_number":"110502532201",
         "certificate_url":null,
         "provider_policy_id":0
      },
      "active":false,
      "submitted_to_provider":false,
      "created_at":"2022-03-08T15:34:58.682Z",
      "updated_at":"2022-03-08T15:34:58.682Z"
   }
}

Sample Request Payload

{
  "vehicle_make": "Toyota",
  "vehicle_model": "Prado",
  "address": "close 4 festac town lagos",
  "state": "Lagos",
  "identification_name": "NIN",
  "identification_url": "https://via.placeholder.com/300/09f/fff.png",
  "registration_number": "akd223gf",
  "engine_number": "52WVC10338",
  "chassis_number": "5YJSA1DG9DFP14705",
  "vehicle_color": "black",
  "year_of_manufacture": "2018",
  "title": "Mr",
  "first_name": "john",
  "last_name": "doe",
  "email": "[e-mail]",
  "phone_number": "07064378577",
  "date_of_birth": "1986-12-31",
  "product_id": "a72c4e3c-e868-4782-bb35-df6e3344ae6c",
  "vehicle_category": "Car"
}

Buy Comprehensive Auto

Use this end-point to buy comprehensive auto insurance from AIICO.

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

Request Body

Name	Type	Description
first_name*	string	Customer's legal first name
last_name*	string	Customer's legal last name
email*	string	Customer's email address
phone_number*	string	Customer's phone number
date_of_number*	string	Customer's date of birth as it appears on legal documents
address*	string	Valid physical address
state*	string	Customer's state of residence
product_id*	string	This is the ID of the insurance plan.
identification_name*	string	The name of the customer's identification type
identification_url*	string	The image URL of customer's ID
bvn*	string	Customer's BVN number. To verify customer's identity
registration_number*	string	Customer's vehicle plate number
vehicle_category*	string	The category of customer's vehicle
vehicle_cost*	string	The cost of customer's vehicle
year_of_manufacture*	string	The year customer's vehicle was manufactured
title_id*	string	The title your customer is addressed by e.g. Mrs.

200: OK Success Response

{
   "responseCode":1,
   "responseText":"comprehensive policy purchase successful",
   "data":{
      "id":"d7fbc352-dad1-4a54-bf18-0a1734fe3d35",
      "first_name":"Susan",
      "last_name":"Blanchard",
      "email":"[e-mail]",
      "phone":"[phone]",
      "dob":"2004-03-11",
      "customer_id":"a0b8eaf4-0437-4525-bc3f-01dc56cf3627",
      "buyer_id":"a0b8eaf4-0437-4525-bc3f-01dc56cf3627",
      "product_id":"24140c74-fc6f-42f5-a0d2-24800b22d80a",
      "product_category_id":"978ced0d-0e05-4de6-b43a-b408c0e8b95e",
      "purchase_id":"984f5d6a-ea82-4fea-b98f-bfad5bece767",
      "distributor_id":"76d5970a-d46b-43df-beb3-8f3117b7a60f",
      "provider_id":"63dbfce7-a743-47bd-bc49-b95703054aa1",
      "activation_date":null,
      "start_date":null,
      "expiration_date":null,
      "market_price":75000,
      "genius_price":75000,
      "profit":15000,
      "meta":{
         "vehicle_registration_number":"akd332hg",
         "payload":{
            "identificationName":"NIMC Card",
            "identificationUrl":"https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/5ed0f66d-3f29-483c-b5ac-f207eb1fecaf-susan_blanchard_1646758276792_screenshot-2021-08-16-at-3.58.28-pm.png",
            "titleId":"0a439e44-98cf-e711-83b7-44850015c0e7",
            "subclassSectCovtypeId":"06ee8b29-47e7-e711-a2be-005056a02281",
            "productId":"f1326cce-47e7-e711-a2be-005056a02281",
            "smsTel":"[phone]",
            "physicalAddrs":"Placeat in et dolor",
            "pryEmail":"[e-mail]",
            "dateOfBirth":"2004-03-11",
            "lastName":"Blanchard",
            "firstName":"Susan",
            "premiumAmount":75000,
            "vehicleAmount":2500000,
            "color":"Red",
            "chasisNo":"1NXBR32E97Z919065",
            "engineNo":"1ZZ6686285",
            "bodyType":"Car",
            "yrManft":"2013",
            "model":"Corolla",
            "regNo":"akd332hg",
            "make":"Toyota"
         }
      },
      "active":false,
      "submitted_to_provider":false,
      "created_at":"2022-03-08T15:51:18.654Z",
      "updated_at":"2022-03-08T15:51:18.654Z"
   }
}

401: Unauthorized Unauthorized response

{
  "responseCode": 0,
  "responseText": "Unauthorized",
  "errorData": null,
  "data": {}
}

Sample Request Payload

{
  "vehicle_make": "Toyota",
  "vehicle_model": "Corolla",
  "address": "close 4 festac town lagos",
  "state": "Lagos",
  "identification_name": "NIN",
  "identification_url": "https://via.placeholder.com/300/09f/fff.png",
  "engine_number": "52WVC10338",
  "chassis_number": "1HGBH41JXMN109186",
  "vehicle_color": "Black",
  "year_of_manufacture": "2018",
  "title": "Mr",
  "vehicle_cost": 2500000,
  "first_name": "Mary",
  "last_name": "Olaleye",
  "email": "[e-mail]",
  "phone_number": "07064378577",
  "date_of_birth": "1985-03-23",
  "product_id": "24140c74-fc6f-42f5-a0d2-24800b22d80a",
  "vehicle_category": "Car"
}

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

Auxiliary