Aiico

Connect the following endpoints to buy and manage content insurance from AIICO.

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

Buy Office Content Cover

Use this end-point to buy Content Cover for Office belongings for your customers from AIICO.

See Auxiliary for more endpoints

POST https://api.mycover.ai/v1/products/aiico/buy-office-content-cover

See Auxiliary APIs for additional data for - GET /title - GET /gender

Request Body

Name	Type	Description
pre_ownership*	string
tenancy*	string
address*	string	Customer's legal address
office_items*	array	Array of office items objects. Check below for description
lga*	string	LGA of the customer. Refer to features list using miscellaneous link below
is_full_year*	string	Customer's purchase type whether a full year purchase or not. (true, false)
first_name*	string	Customer's legal first name
last_name*	string	Customer's legal last name
email*	string	Customer's valid email address
phone_number*	string	Customer's valid phone number
date_of_birth*	string	Customer's date of birth
title*	string	Title of customer ('Mr', 'Engr'....). Refer to titles list in miscellaneous link below.
gender*	string	Customer's gender
identification_name*	string	ID type of the customer. Refer to ID types using miscellaneous link below
identification_url*	string	Image URL of the customer ID
insurance_start_date*	string	Start date of the insurance
product_id*	string	ID of the insurance plan

200: OK

{
    "responseCode": 1,
    "responseText": "policy purchase successful",
    "data": {
        "id": "1b9d36bf-f0ae-4053-a5f9-83e8d5e3aa28",
        "app_mode": "test",
        "active": true,
        "first_name": "Kato",
        "last_name": "Pearson",
        "email": "[e-mail]",
        "dob": "2004-03-05",
        "phone": "[phone]",
        "start_date": "2023-09-13T00:00:00.000Z",
        "expiration_date": "2024-09-13T00:00:00.000Z",
        "activation_date": "2023-09-13T00:00:00.000Z",
        "distributor_id": "92e39bc5-6110-4dcb-8583-bc50c2e6922b",
        "customer_id": "b93afc90-54ab-4d1c-8e35-907019b05e7f",
        "buyer_id": "b93afc90-54ab-4d1c-8e35-907019b05e7f",
        "product_id": "57a6df7e-87f4-40e8-bf78-5b1f85c6d87e",
        "product_category_id": "9e9d5fe0-2129-41a5-9f44-9c9fe90b3855",
        "provider_id": "63dbfce7-a743-47bd-bc49-b95703054aa1",
        "meta": {
            "payload": {
                "wef": "2023-09-13",
                "wet": "2024-09-13",
                "lgaId": "fc33ae6c-98e4-e711-83bb-44850015c0e4",
                "smsTel": "[phone]",
                "TitleId": "0c439e44-98cf-e711-83b7-44850015c0e7",
                "address": "Est est cillum neque",
                "tenancy": "Debitis consequat V",
                "GenderId": "01439e44-98cf-e711-83b7-44850015c0e7",
                "lastName": "Pearson",
                "pryEmail": "[e-mail]",
                "firstName": "Kato",
                "productId": "1a2f284a-6325-e811-a2cc-005056a02281",
                "isFullYear": true,
                "dateOfBirth": "2004-03-05",
                "officeItems": [
                    {
                        "name": "Air conditioner",
                        "amount": "150000"
                    },
                    {
                        "name": "Table",
                        "amount": "100000"
                    },
                    {
                        "name": "Chairs",
                        "amount": "130000"
                    }
                ],
                "preOwnership": "Ea ab amet blanditi",
                "physicalAddrs": "Est est cillum neque",
                "valueOfContents": "0150000100000130000",
                "identificationUrl": "https://via.placeholder.com/300/09f/fff.png",
                "identificationName": "International Passport",
                "subclassSectCovtypeId": "9668e363-5d25-e811-a2cc-005056a02281"
            },
            "policy_number": "120500512301",
            "certificate_url": null,
            "provider_policy_id": 0
        },
        "genius_price": 10000,
        "market_price": 10000,
        "purchase_id": "540305c4-7ea6-498b-a44f-ab60a0c045dd",
        "profit": 2000,
        "submitted_to_provider": true,
        "updated_at": "2023-09-13T08:02:28.714Z",
        "created_at": "2023-09-13T08:02:28.714Z",
        "deleted_at": null,
        "inspection_id": null
    }
}

The office_items parameter above is an array of object. Below are the parameters of the object.

"office_items": [
    {
      "name": "string",
      "amount": 0
    }
  ]

Sample Request Payload

{
   "first_name":"Kato",
   "last_name":"Pearson",
   "email":"[e-mail]",
   "phone_number":"[phone]",
   "date_of_birth":"2004-03-05",
   "address":"Est est cillum neque",
   "gender":"Male",
   "product_id":"57a6df7e-87f4-40e8-bf78-5b1f85c6d87e",
   "pre_ownership":"Ea ab amet blanditi",
   "identification_name":"International Passport",
   "identification_url":"https://via.placeholder.com/300/09f/fff.png",
   "tenancy":"Debitis consequat V",
   "lga":"ABIA-Ikwuano",
   "is_full_year":true,
   "insurance_start_date":"2022-03-10",
   "title":"Excellency",
   "office_items":[
      {
         "name":"Air conditioner",
         "amount":"150000"
      },
      {
         "name":"Table",
         "amount":"100000"
      },
      {
         "name":"Chairs",
         "amount":"130000"
      }
   ]
} 

Buy Home Content Cover

Use this end-point to buy Content Cover for Home belongings for your customers from AIICO.

See Auxiliary for more related endpoints

POST https://api.mycover.ai/v1/products/aiico/buy-home-content-cover

See Auxiliary APIs for additional data for - GET /title - GET /gender

Request Body

Name	Type	Description
pre_ownership*	string
tenancy*	string
description*	string
address*	string
home_items*	array of objects
lga*	string
is_full_year*	string
first_name*	string
last_name*	string
email*	string
phone_number*	string
date_of_birth*	string
title*	string
gender*	string
identification_name*	string
identification_url*	string
insurance_start_date*	string
product_id*	string

200: OK

{
   "responseCode":1,
   "responseText":"policy purchase successful",
   "data":{
      "first_name":"Cassandra",
      "last_name":"Stewart",
      "email":"[e-mail]",
      "phone":"[phone]",
      "dob":"2004-03-04",
      "customer_id":"49731594-f147-4d87-a119-1963c083399f",
      "buyer_id":"49731594-f147-4d87-a119-1963c083399f",
      "product_id":"0386fe30-a3be-4ff2-a64a-048d2c99504b",
      "product_category_id":"9e9d5fe0-2129-41a5-9f44-9c9fe90b3855",
      "distributor_id":"76d5970a-d46b-43df-beb3-8f3117b7a60f",
      "provider_id":"63dbfce7-a743-47bd-bc49-b95703054aa1",
      "activation_date":"2022-03-03",
      "start_date":"2022-03-03",
      "expiration_date":"Fri, 02 Sep 2022 23:00:00 GMT",
      "meta":{
         "policy_number":"121501332201",
         "certificate_url":null,
         "provider_policy_id":0,
         "payload":{
            "preOwnership":"Facere unde et vero",
            "tenancy":"Dolor ullamco explic",
            "address":"Aliqua Sint esse l",
            "homeItems":[
               {
                  "name":"Mallory Smith",
                  "amount":"53"
               },
               {
                  "name":"Steven Knox",
                  "amount":"62"
               }
            ],
            "subclassSectCovtypeId":"3f439e93-5d25-e811-a2cc-005056a02281",
            "lgaId":"fc33ae6c-98e4-e711-83bb-44850015c0e4",
            "isFullYear":false,
            "valueOfContents":"05362",
            "TitleId":"0c439e44-98cf-e711-83b7-44850015c0e7",
            "GenderId":"01439e44-98cf-e711-83b7-44850015c0e7",
            "firstName":"Cassandra",
            "lastName":"Stewart",
            "dateOfBirth":"2004-03-04",
            "pryEmail":"[e-mail]",
            "smsTel":"[phone]",
            "physicalAddrs":"Aliqua Sint esse l",
            "wef":"2022-03-03",
            "wet":"Fri, 02 Sep 2022 23:00:00 GMT",
            "productId":"52f33528-6325-e811-a2cc-005056a02281",
            "identificationName":"Drivers License",
            "identificationUrl":"https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/3cde40c3-ec99-4c6a-91d4-cc90a8f345fa-cassandra_stewart_1647509840772_screenshot-2021-08-16-at-3.58.28-pm.png"
         }
      },
      "active":true,
      "genius_price":"10000.00",
      "market_price":"10000.00",
      "profit":2000,
      "purchase_id":"7247d8bf-8e6e-4840-a39f-027717a4a5ca",
      "submitted_to_provider":true,
      "id":"bf90045a-3b96-4d8b-a87c-8a0fe7633ed3",
      "created_at":"2022-03-17T08:37:26.005Z",
      "updated_at":"2022-03-17T08:37:26.005Z"
   }
}

Sample Request Payload

{
   "first_name":"Evangeline",
   "last_name":"Frederick",
   "email":"[e-mail]",
   "phone_number":"[phone]",
   "date_of_birth":"2004-03-11",
   "address":"Officiis et quo inci",
   "gender":"Male",
   "product_id":"0386fe30-a3be-4ff2-a64a-048d2c99504b",
   "pre_ownership":"In fugiat ab in sin",
   "identification_name":"Drivers License",
   "identification_url":"https://via.placeholder.com/300/09f/fff.png",
   "tenancy":"Sed qui sed animi c",
   "lga":"ABIA-Ikwuano",
   "is_full_year":false,
   "description":"Praesentium nisi exe",
   "insurance_start_date":"2022-03-09",
   "title":"Clergyman",
   "home_items":[
      {
         "name":"Television",
         "amount":"150000"
      },
      {
         "name":"Sound bar",
         "amount":"120000"
      },
      {
         "name":"Air conditioner",
         "amount":"200000"
      },
      {
         "name":"Furnitures",
         "amount":"200000"
      }
   ]
}

Buy Shop Content Cover

Buy AIIco shop content cover for SME business owners

See Auxiliary for more related endpoints

POST https://api.mycover.ai/v1/products/aiico/buy-shop-content-cover

See Auxiliary APIs for additional data for - GET /title - GET /gender

Request Body

Name	Type	Description
shop_type*	string	The type of the shop
nature_of_business*	string	The nature of the business
nature_of_stock*	string	The nature of the stock either perishable, non perishable, or mixed
stock_keeping*	boolean	Is it a stock keeping shop?
stock_taking_interval*	string	How often do you do stock taking? Either daily, weekly, monthly, quarterly, or yearly
stock_amount*	number	The total cost of all the goods in the shop
address*	string	The shop address
title*	string	The shop owner's title e.g Chief
gender*	string	The shop owner's gender e.g Male
identification_name*	string	Type of identification. Acceptable: Drivers License, NIN, International Passport
identification_url*	string	The image url after uploading the identification
first_name*	string	Owner's first name
last_name*	string	Owner's last name
email*	string	Owner's email
phone_number*	string	Owner's phone number
date_of_birth*	string	Owner's date of birth
product_id*	string	The product's UID

200: OK

{
    "responseCode": 1,
    "responseText": "policy purchase successful",
    "data": {
        "id": "f853ce34-fe3e-4646-8768-b0322d1f4599",
        "app_mode": "test",
        "active": true,
        "first_name": "Jahohash",
        "last_name": "Bilblo",
        "email": "[e-mail]",
        "dob": "1996-03-11",
        "phone": "09027773827",
        "start_date": "2023-09-05T00:00:00.000Z",
        "expiration_date": "2024-09-05T00:00:00.000Z",
        "activation_date": "2023-09-05T00:00:00.000Z",
        "distributor_id": "92e39bc5-6110-4dcb-8583-bc50c2e6922b",
        "customer_id": "3df902c8-5475-4fdb-9a45-d09aec17c94a",
        "buyer_id": "3df902c8-5475-4fdb-9a45-d09aec17c94a",
        "product_id": "58a6df7e-87f4-40e8-bf78-5b1f85c6d87f",
        "product_category_id": "9e9d5fe0-2129-41a5-9f44-9c9fe90b3855",
        "provider_id": "63dbfce7-a743-47bd-bc49-b95703054aa1",
        "meta": {
            "payload": {
                "wef": "2023-09-05",
                "wet": "2024-09-05",
                "smsTel": "09027773827",
                "TitleId": "08439e44-98cf-e711-83b7-44850015c0e7",
                "address": "Officiis et quo inci",
                "GenderId": "01439e44-98cf-e711-83b7-44850015c0e7",
                "lastName": "Bilblo",
                "pryEmail": "[e-mail]",
                "firstName": "Jahohash",
                "productId": "939e9f6c-6325-e811-a2cc-005056a02281",
                "isFullYear": true,
                "typeOfShop": "Retail",
                "dateOfBirth": "1996-03-11",
                "stockAmount": 700000,
                "natureOfStock": "perishable",
                "physicalAddrs": "Officiis et quo inci",
                "premiumAmount": "15000.00",
                "keepsStockBook": true,
                "stockTakingMode": "daily",
                "natureOfBusiness": "Alumako",
                "identificationUrl": "https://via.placeholder.com/300/09f/fff.png",
                "natureOfStructure": "Alumako",
                "identificationName": "Drivers License",
                "subclassSectCovtypeId": "99e246a7-5d25-e811-a2cc-005056a02281",
                "keepsStockBookInSafePlace": true
            },
            "policy_number": "120600282301",
            "certificate_url": null,
            "provider_policy_id": 0
        },
        "genius_price": 15000,
        "market_price": 15000,
        "purchase_id": "5aefcb2e-a84e-4c3f-bf6e-0eeef481dc0a",
        "profit": 3000,
        "submitted_to_provider": true,
        "updated_at": "2023-09-05T10:55:14.172Z",
        "created_at": "2023-09-05T10:55:14.172Z",
        "deleted_at": null,
        "inspection_id": null
    }
}

Sample payload

{
  "shop_type": "Retail",
  "nature_of_business": "Alumako",
  "nature_of_stock": "perishable",
  "stock_keeping": true,
  "stock_taking_interval": "daily",
  "stock_amount": 700000,
  "address": "Officiis et quo inci",
  "title": "Chief",
  "gender": "Male",
  "identification_name": "Drivers License",
  "identification_url": "https://via.placeholder.com/300/09f/fff.png",
  "first_name": "Jahohash",
  "last_name": "Bilblo",
  "email": "[e-mail]",
  "phone_number": "09027773827",
  "date_of_birth": "1996-03-11",
  "product_id": "58a6df7e-87f4-40e8-bf78-5b1f85c6d87f"
}

pageAuxiliary

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