Sovereign Trust

Connect any or all of the following endpoints to buy and manage auto-products from STI.

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

Buy comprehensive auto insurance

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

Request Body

Name
Type
Description

vehicle_make*

string

This is the brand of the vehicle

vehicle_model*

string

This is the model of the vehicle

address*

string

Customer's valid address

insurance_start_date*

string

This is the insurance start date

vehicle_registration_number*

string

Vehicle's plate number

engine_number*

string

This is the vehicle's engine number

chassis_number*

string

Chasis number of the vehicle

vehicle_insurance_type*

string

This is the insurance type of the vehicle ('private', 'commercial')

first_name*

string

Customer's legal first name

last_name*

string

Customer's legal last name

email*

string

Customer's valid email address

date_of_birth*

string

Customer's valid date of birth

phone_number*

string

Customer's valid phone number

product_id*

string

This is the ID of the insurance plan.

gender*

string

Male or Female

vehicle_type*

string

Type of vehicle. E.g Car

vehicle_value*

number

How much the vehicle was bought

number_of_months*

number

How many months you want to insure your vehicle for. 1 - 12

identification_image_url

string

A link to your identity card

vehicle_color

string

Colour of the vehicle

vehicle_license_url*

string

Link to the uploaded vehicle license

{
    "responseCode": 1,
    "responseText": "Purchase Successful",
    "data": {
        "policy": {
            "id": "896ab4b0-b26c-42f7-a986-467e547e636d",
            "app_mode": "test",
            "active": false,
            "first_name": "jennifer",
            "last_name": "onye",
            "email": "[email protected]",
            "dob": "1994-08-28",
            "phone": "07064378577",
            "start_date": "2022-12-08T00:00:00.000Z",
            "expiration_date": null,
            "activation_date": "2022-12-08T00:00:00.000Z",
            "distributor_id": "10cd1dac-3a5c-43ee-b935-641d53f9cb27",
            "customer_id": "9dc7609b-0609-4df9-96db-f0472d208cf2",
            "buyer_id": "9dc7609b-0609-4df9-96db-f0472d208cf2",
            "product_id": "dd81a37f-e621-4f9b-9427-5306b8a5b5e5",
            "product_category_id": "978ced0d-0e05-4de6-b43a-b408c0e8b95e",
            "provider_id": null,
            "meta": {
                "payload": {
                    "plateNumber": "akd345gf",
                    "vehicleMake": "1",
                    "vehicleType": "Car",
                    "customerName": "jennifer onye",
                    "engineNumber": "2AR0148325",
                    "vehicleColor": "BLACK",
                    "vehicleModel": "218",
                    "vehicleValue": 1200000,
                    "chassisNumber": "JTMZF31V095013882",
                    "customerEmail": "[email protected]",
                    "customerPhone": "07064378577",
                    "vehicleYearMft": "2015",
                    "customerAddress": "Surulere, Lagos",
                    "vehicleInsuranceType": "Commercial",
                    "insuranceCommencementDate": "2022-12-08",
                    "vehicleRegistrationNumber": "akd345gf"
                },
                "policy_number": "PAC/PP/03/2024/AC/8502",
                "certificate_url": null,
                "vehicle_registration_number": "AKD345GF"
            },
            "genius_price": 5000,
            "market_price": 5000,
            "purchase_id": "1611bba6-36b4-4378-a353-6fb9e7cc8530",
            "profit": 1000,
            "submitted_to_provider": true,
            "updated_at": "2024-03-01T15:15:49.152Z",
            "created_at": "2024-03-01T15:15:49.152Z",
            "deleted_at": null,
            "inspection_id": null
        }
    }
}
{
    "first_name": "jennifer",
    "last_name": "onye",
    "email": "[email protected]",
    "date_of_birth": "1994-08-28",
    "phone_number": "07064378577",
    "gender": "Male",
    "address": "Surulere, Lagos",
    "vehicle_make": "1",
    "vehicle_model": "218",
    "vehicle_registration_number": "akd345gf",
    "vehicle_insurance_type": "Commercial",
    "vehicle_year_manufactured": "2015",
    "vehicle_type": "Car",
    "vehicle_value": 1200000,
    "vehicle_color": "BLACK",
    "vehicle_license_url": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/ff1e6379-03b9-48b6-a250-886a02041bf9-aiico-logo.jpeg",
    "insurance_start_date": "2022-12-08",
    "engine_number": "2AR0148325",
    "chassis_number": "JTMZF31V095013882",
    "number_of_months": 1,
    "identification_image_url": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/ff1e6379-03b9-48b6-a250-886a02041bf9-aiico-logo.jpeg",
    "product_id": "b0d0f39c-0b8a-452f-a876-78bef8de3347"
}

Buy Micro comprehensive auto insurance

POST https://api.mycover.ai/v1/products/sti/buy-micro-comprehensive

Request Body

Name
Type
Description

vehicle_make*

string

This is the brand of the vehicle

vehicle_model*

string

This is the model of the vehicle

address*

string

Customer's valid address

insurance_start_date*

string

This is the insurance start date

vehicle_registration_number*

string

Vehicle's plate number

engine_number*

string

This is the vehicle's engine number

chassis_number*

string

Chasis number of the vehicle

vehicle_insurance_type*

string

This is the insurance type of the vehicle ('private', 'commercial')

first_name*

string

Customer's legal first name

last_name*

string

Customer's legal last name

email*

string

Customer's valid email address

date_of_birth*

string

Customer's valid date of birth

phone_number*

string

Customer's valid phone number

product_id*

string

This is the ID of the insurance plan.

gender*

string

Male or Female

vehicle_type*

string

Type of vehicle. E.g Car

vehicle_value*

number

How much the vehicle was bought

number_of_months*

number

How many months you want to insure your vehicle for. 1 - 12

identification_image_url

string

A link to your identity card

vehicle_color

string

Colour of the vehicle

vehicle_license_url*

string

Link to the uploaded vehicle license

{
    "responseCode": 1,
    "responseText": "Purchase Successful",
    "data": {
        "policy": {
            "id": "b887f9d8-14e6-4d72-9a42-f34ca965aa4e",
            "app_mode": "test",
            "active": false,
            "first_name": "jennifer",
            "last_name": "onye",
            "email": "[email protected]",
            "dob": "1994-08-28",
            "phone": "07064378577",
            "start_date": "2022-12-08T00:00:00.000Z",
            "expiration_date": null,
            "activation_date": "2022-12-08T00:00:00.000Z",
            "distributor_id": "10cd1dac-3a5c-43ee-b935-641d53f9cb27",
            "customer_id": "9dc7609b-0609-4df9-96db-f0472d208cf2",
            "buyer_id": "9dc7609b-0609-4df9-96db-f0472d208cf2",
            "product_id": "dd81a37f-e621-4f9b-9427-5306b8a5b5e5",
            "product_category_id": "978ced0d-0e05-4de6-b43a-b408c0e8b95e",
            "provider_id": null,
            "meta": {
                "payload": {
                    "plateNumber": "akd345gf",
                    "vehicleMake": "1",
                    "vehicleType": "Car",
                    "customerName": "jennifer onye",
                    "engineNumber": "2AR0148325",
                    "vehicleColor": "BLACK",
                    "vehicleModel": "218",
                    "vehicleValue": 1200000,
                    "chassisNumber": "JTMZF31V095013882",
                    "customerEmail": "[email protected]",
                    "customerPhone": "07064378577",
                    "vehicleYearMft": "2015",
                    "customerAddress": "Surulere, Lagos",
                    "vehicleInsuranceType": "Commercial",
                    "insuranceCommencementDate": "2022-12-08",
                    "vehicleRegistrationNumber": "akd345gf"
                },
                "policy_number": "PAC/PP/03/2024/AC/1162",
                "certificate_url": null,
                "vehicle_registration_number": "AKD345GF"
            },
            "genius_price": 5000,
            "market_price": 5000,
            "purchase_id": "9c6f691a-a177-4c06-ad27-57cd8895981f",
            "profit": 1000,
            "submitted_to_provider": true,
            "updated_at": "2024-03-01T15:18:31.101Z",
            "created_at": "2024-03-01T15:18:31.101Z",
            "deleted_at": null,
            "inspection_id": null
        }
    }
}
{
    "first_name": "jennifer",
    "last_name": "onye",
    "email": "[email protected]",
    "date_of_birth": "1994-08-28",
    "phone_number": "07064378577",
    "gender": "Male",
    "address": "Surulere, Lagos",
    "vehicle_make": "1",
    "vehicle_model": "218",
    "vehicle_registration_number": "awd345gf",
    "vehicle_insurance_type": "Commercial",
    "vehicle_year_manufactured": "2015",
    "vehicle_type": "Car",
    "vehicle_value": 1200000,
    "vehicle_color": "BLACK",
    "insurance_start_date": "2022-12-08",
    "engine_number": "2AR0141315",
    "chassis_number": "JTMZF31V095013811",
    "number_of_months": 1,
    "identification_image_url": "https://via.placeholder.com/300/09f/fff.png",
    "vehicle_license_url": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/ff1e6379-03b9-48b6-a250-886a02041bf9-aiico-logo.jpeg",
    "product_id": "b0d0f4ad-0b8a-452f-a876-78bef8de3873"
}

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

Auxiliary

Last updated

Was this helpful?