Auxiliary

Find additional API endpoints for fetching or posting auxiliary data as a complement to other APIs.

Get Auxiliary Data for AIICO Products

Get Aiico-specific additional data for purchasing AIIco products.

GET https://api.mycover.ai/v1/products/aiico/get-feature-list

This endpoint fetches all other required parameters for purchasing AIICO products. Use query parameters for getting filtered results. Example: https://api.mycover.ai/v1/products/aiico/get-feature-list?feature=color-list

Query Parameters

Name	Type	Description
feature	string	color-list | body-types | manufacture-year | titles | lgas | genders | countries

200: OK

{
    "responseCode": 1,
    "responseText": "Ok",
    "data": {
        "colorList": [
            "AQUA",
            "AQUAMARINE",
            "AZURE",
            "BEIGE",
            "BISQUE",
            "BLACK",
            "BLUE",
            ...
        ],
        "bodyTypes": [
            "Bus",
            "Car",
            ...
        ],
        "manufactureYear": [
            "2000",
            "2001",
            "2002",
            ...
        ],
        "titles": [
            "Chief",
            "Clergyman",
            "Doctor",
            ...
        ],
        "lgas": [
            "ABIA-Aba North",
            "ABIA-Aba South",
            "ABIA-Arochukwu",
           ...
        ],
        "genders": [
            "Female",
            "Male"
        ],
        "countries": [
            "Afghanistan",
            "Albania",
            "Algeria",
            "AMERICAN SAMOA",
         ...
        ]
    }
}

Get Countries

Get a list of all the countries in the world.

GET https://api.mycover.ai/v1/countries

Query Parameters

Name	Type	Description
feature	string	color-list | body-types | manufacture-year | titles | lgas | genders | countries

200: OK

Get Countries with States

Get a list of all the countries with their respective states/capitals.

GET https://api.mycover.ai/v1/countries-with-states

200: OK

Get States with LGAs

Get a list of all states in Nigeria with their Local Government Areas.

GET https://api.mycover.ai/v1/states-with-lga

200: OK

Get Local Government Areas

Get a list of all Local Government Areas in Nigeria.

GET https://api.mycover.ai/v1/lgas

200: OK

Get Colour List

Get a list of colors acceptable by most providers.

GET https://api.mycover.ai/v1/color-list

200: OK

Get Vehicle Types

Get a list of vehicle types such as Bus.

GET https://api.mycover.ai/v1/vehicle-body-types

200: OK

Get Manufacture Year

Get the manufacturing year of your customer's vehicle.

GET https://api.mycover.ai/v1/manufacture-year

200: OK

Get Genders

Get a list of genders such as Male.

GET https://api.mycover.ai/v1/genders

200: OK

Get Identification Types

Get a list of identification types e.g International Passport.

GET https://api.mycover.ai/v1/identification-types

200: OK

{
   "responseCode":1,
   "responseText":"Identification types",
   "data":{
      "verification_type":[
         "National Passport",
         "National ID",
         "Drivers License",
         "NIMC Card",
         "Intl Passport",
         "Voters Card"
      ]
   }
}

Get Owner Titles

Get a list of all the names used to describe the customer's status.

GET https://api.mycover.ai/v1/products/mcg/owner-titles

200: OK

{
   "responseCode":1,
   "responseText":"Owner Titles Retrieved",
   "data":{
      "owner_titles":[
         "Mr",
         "Mrs",
         "Engr",
         "Chief",
         "Clergyman",
         "Doctor",
         "Excellency",
         "Honorable",
         "Master",
         "Miss",
         "Professor",
         "Elder"
      ]
   }
}

Get Vehicle Brand By Provider

Get the vehicle make by each provider for your customer's selection.

GET https://api.mycover.ai/v1/products/get-vehicle-make

Query Parameters

Name	Type	Description
year*	string	Vehicle Year
provider*	string	Insurance Provider (e.g aiico, leadway)

200: OK

{
   "responseCode":1,
   "responseText":"Car Make for 2013",
   "data":[
      "ACURA",
      "ALFA ROMEO",
      "APRILIA",
      "ARCTIC CAT",
      ...
   ]
}

Get Vehicle Model By Provider

Get the model of your customer's vehicle.

GET https://api.mycover.ai/v1/products/get-vehicle-model

Query Parameters

Name	Type	Description
year*	string	Vehicle Year
make_id*	string	Vehicle Make Id. Using the id from the /products/get-vehicle-make endpoint
provider*	string	Insurance provider (e.g aiico, leadway)

200: OK

{
    "responseCode": 1,
    "responseText": "Vehicle Models Retrieved!",
    "data": {
        "vehicle_model": [
            {
                "modelName": "600H L",
                "model_id": "3060"
            },
            {
                "modelName": "CT 200H",
                "model_id": "3035"
            },
            ...
        ]
    }
}

File Upload

Use this endpoint to upload a file

POST https://api.mycover.ai/v1/upload-file

Upload files as form-data with the key as "file"

Request Body

Name	Type	Description
file*	File	Append file as form-data

200: OK

{
   responseCode: 1,
   responseText: "File upload successful",
   data: { 
      file_url: "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/f143da93-ad23-4477-87c6-3ef35db5ff2b-Darius_Beach_1647614018187_Screenshot-2021-09-21-at-1.19.34-PM.png"
   },
}