Sovereign Trust Insurance

The policy covers the risks of damage to the gadgets insured caused by screen damage and liquid spillage during the coverage period.

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

Buy gadget insurance

Use this end-point to buy gadget insurance cover.

POST https://api.mycover.ai/v1/products/sti/buy-gadget-cover

Request Body

Name	Type	Description
date_of_birth*	date	Supported format is "YYYY-MM-DD"
first_name*	string	Customer first name
last_name*	string	Customer last name
email*	string	Customer valid email address
phone_number*	string	Customer valid phone number
gender*	string	Supported values are "Male", "Female"
address*	string	Company's address
id_image_url*	string	Id image url gotten from uploading an image of the customer id. Check the miscellaneous section for file upload.
occupation*	string	Customer occupation
title*	string	Customer title eg. "Mr", "Mrs", "Miss", "Engr"
model_number*	string	Device model number
device_type*	string	Supported values are "Phone", "Laptop", "Others"
device_make*	string	Device make. eg Samsung
device_model*	string	Device model. eg. A50
device_color*	string	Color of the device. eg. black
imei_one*	string	Device imei number one
date_of_purchase*	date	Supported format is "YYYY-MM-DD"
device_value*	number	Price of the divice
device_serial_number*	string	Device serial number
imei_two	string	Device imei number two
device_about_image_url*	string	Screenshot of the device about image. Check the miscellaneous section for file upload.

200: OK

{
    "responseCode": 1,
    "responseText": "Purchase Successful",
    "data": {
        "policy": {
            "id": "ba3f19a4-e1b0-406b-9fca-c0072ba4b49d",
            "app_mode": "test",
            "active": true,
            "first_name": "Wale",
            "last_name": "Jameson",
            "email": "[e-mail]",
            "dob": "2000-12-12",
            "phone": "08034567890",
            "start_date": "2024-11-23T00:00:00.000Z",
            "expiration_date": "2025-11-23T00:00:00.000Z",
            "activation_date": "2024-11-23T00:00:00.000Z",
            "distributor_id": "a01bec68-9b4e-4996-adb6-2c86b559db95",
            "customer_id": "a3cdc4a7-61df-45a3-9212-e996146bd7f5",
            "buyer_id": "a3cdc4a7-61df-45a3-9212-e996146bd7f5",
            "product_id": "eec0711c-1e4a-453b-a26c-2726e0a1a7cc",
            "product_category_id": "1e87194d-5eb1-48b6-8837-a9cbc78d4ec3",
            "provider_id": "2fa7f726-19e1-438c-87aa-574ca1719987",
            "meta": {
                "payload": {
                    "email": "[e-mail]",
                    "phone": "08034567890",
                    "gender": "Male",
                    "address": "Lagos Lagos",
                    "last_name": "Jameson",
                    "first_name": "Wale",
                    "device_make": "samsung",
                    "device_type": "Phone",
                    "imei_number": "10410120230888917",
                    "device_color": "Black",
                    "device_model": "NP6BDLP",
                    "device_value": 50000,
                    "id_image_url": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/ff1e6379-03b9-48b6-a250-886a02041bf9-aiico-logo.jpeg",
                    "date_of_purchase": "2020-01-10",
                    "device_serial_number": "ZVZ9S77PD6V"
                },
                "mca_payload": {
                    "email": "[e-mail]",
                    "title": "Mr",
                    "gender": "Male",
                    "address": "Lagos Lagos",
                    "last_name": "Jameson",
                    "first_name": "Wale",
                    "occupation": "Engineer",
                    "product_id": "eec0711c-1e4a-453b-a26c-2726e0a1a7cc",
                    "device_make": "samsung",
                    "device_type": "Phone",
                    "imei_number": "10410120230888917",
                    "device_color": "Black",
                    "device_model": "NP6BDLP",
                    "device_value": 50000,
                    "id_image_url": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/ff1e6379-03b9-48b6-a250-886a02041bf9-aiico-logo.jpeg",
                    "model_number": "ZV1SVGQ026",
                    "phone_number": "08034567890",
                    "date_of_birth": "2000-12-12",
                    "date_of_purchase": "2020-01-10",
                    "device_serial_number": "ZVZ9S77PD6V",
                    "device_about_image_url": "https://via.placeholder.com/300/09f/fff.png"
                },
                "policy_number": "ACC/AR/11/2024/HQ/8836",
                "certificate_url": null,
                "device_serial_number": "ZVZ9S77PD6V"
            },
            "genius_price": 2500,
            "market_price": 2500,
            "purchase_id": "3ca8b5ed-c368-4474-81e9-2c6b4ab9febe",
            "profit": 500,
            "submitted_to_provider": false,
            "updated_at": "2024-11-23T10:35:32.932Z",
            "created_at": "2024-11-23T10:35:32.932Z",
            "history": null,
            "deleted_at": null
        }
    }
}

Premium amount is 5% of the cost of the device for phones, 5% for laptops, and 5% for other devices.

Sample Request Payload

{
    "product_id": "eec0711c-1e4a-453b-a26c-2726e0a1a7cc",
    "first_name": "Wale",
    "last_name": "Jameson",
    "phone_number": "08034567890",
    "email": "[e-mail]",
    "gender": "Male",
    "date_of_birth": "2000-12-12",
    "title": "Mr",
    "occupation": "Engineer",
    "address": "Lagos Lagos",
    "id_image_url": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/ff1e6379-03b9-48b6-a250-886a02041bf9-aiico-logo.jpeg",
    "device_type": "Phone",
    "device_make": "samsung",
    "device_model": "NP6BDLP",
    "device_color": "Black",
    "device_about_image_url": "https://via.placeholder.com/300/09f/fff.png",
    "imei_number": "10410120230888917",
    "date_of_purchase": "2020-01-10",
    "device_value": 50000,
    "device_serial_number": "ZVZ9S77PD6V",
    "model_number": "ZV1SVGQ026"
}

♻️ Renew gadget insurance policy

POST https://api.mycover.ai/v1/products/mcg/renew-mcg-gadget

Endpoint for renewing gadget insurance policy

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <YOUR_TOKEN>

Body

Name	Type	Description
policy_id	string	UUID of the policy
id_image_url	string	Id image url gotten from uploading an image of the customer id. Check the auxiliary section for the file upload endpoint.
device_about_image_url	string	Screenshot of the device about image. Check the miscellaneous section for file upload.

Response

200

{
    "responseCode": 1,
    "responseText": "renewal Successful",
    "data": {
        "policy": {
            "id": "bfd0232b-99bb-4ee0-8b60-196b7e6008f7",
            "app_mode": "test",
            "first_name": "Wale",
            "last_name": "Jameson",
            "email": "[e-mail]",
            "phone": "08034567891",
            "dob": "2000-12-12",
            "product_category_id": "1e87194d-5eb1-48b6-8837-a9cbc78d4ec3",
            "activation_date": "2024-02-27T00:00:00.000Z",
            "start_date": "2024-02-27T00:00:00.000Z",
            "expiration_date": "2026-02-26T00:00:00.000Z",
            "market_price": 2500,
            "genius_price": 2500,
            "profit": 500,
            "meta": {
                "payload": {
                    "email": "[e-mail]",
                    "gender": "male",
                    "address": "Lagos",
                    "last_name": "Jameson",
                    "first_name": "Wale",
                    "device_make": "samsung",
                    "device_type": "Phone",
                    "imei_number": "10410020230519",
                    "owner_title": "Mr",
                    "device_color": "Black",
                    "device_model": "AK3BLZ",
                    "device_value": 50000,
                    "id_image_url": "https://via.placeholder.com/300/09f/fff.png",
                    "model_number": "ZV1GQL15",
                    "phone_number": "08034567891",
                    "date_of_birth": "2000-12-12",
                    "device_serial_number": "ZVZ8460D0F",
                    "about_device_screenshot": "https://via.placeholder.com/300/09f/fff.png"
                },
                "policy_number": "ACC/AR/02/2024/HQ/8622",
                "certificate_url": "https://preview.pdfmonkey.io/pdf/web/viewer.html?file=https%3A%2F%2Fpreview.pdfmonkey.io%2Fdocument-render%2F67d1a3ab-b29c-4b8e-8faf-68cc6516e4d8%2FxyL299om32tSyHeNdKf-5-pwRiwsEJxw",
                "provider_policy_id": null,
                "device_serial_number": "ZVZ8460D0F"
            },
            "active": true,
            "submitted_to_provider": true,
            "created_at": "2024-02-27T11:51:54.295Z",
            "updated_at": "2024-02-27T11:55:08.380Z",
            "deleted_at": null,
            "product_id": "ffb0711c-1e4a-453b-a26c-2726e0a1a7bb",
            "customer_id": "a335e043-cfa8-4049-853a-a47d89813ea2",
            "buyer_id": "a335e043-cfa8-4049-853a-a47d89813ea2",
            "distributor_id": "10cd1dac-3a5c-43ee-b935-641d53f9cb27",
            "provider_id": "63dbfce7-a743-47bd-bc49-b95703054aa1",
            "inspection_id": null,
            "purchase_id": "f7b2bc0c-3e2f-4c3b-85e4-b3d4c6d4c797"
        }
    }
}

400

{
    "responseCode": 0,
    "responseText": "Policy not found",
    "path": "/v1/products/mcg/renew-mcg-gadget"
}

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

Auxiliary