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 Third-Party Auto
  • Buy Comprehensive Auto

Was this helpful?

  1. api reference
  2. Products
  3. Auto

Aiico

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

PreviousAutoNextLeadway

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

{
  "responseCode": 0,
  "responseText": "Unauthorized",
  "errorData": null,
  "data": {}
}
{
   "responseCode":1,
   "responseText":"policy purchase successful",
   "data":{
      "id":"65b09302-26de-42b4-80d9-8b137130d3dd",
      "first_name":"Flynn",
      "last_name":"Knowles",
      "email":"zagyfiwi@mailinator.com",
      "phone":"+1 (637) 901-9226",
      "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": "johndoe@gmail.com",
  "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.

{
   "responseCode":1,
   "responseText":"comprehensive policy purchase successful",
   "data":{
      "id":"d7fbc352-dad1-4a54-bf18-0a1734fe3d35",
      "first_name":"Susan",
      "last_name":"Blanchard",
      "email":"noqar@mailinator.com",
      "phone":"+1 (608) 506-9593",
      "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":"+1 (608) 506-9593",
            "physicalAddrs":"Placeat in et dolor",
            "pryEmail":"noqar@mailinator.com",
            "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"
   }
}
{
  "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": "0laleye.mary@gmail.com",
  "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 page for a list of these additional endpoints.

📦
🚘
Auxiliary
Auxiliary
Auxiliary