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 Third-party auto insurance

Connect this endpoint to buy 3rd Party Auto-Product through STI

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

Request Body

NameTypeDescription

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

dob*

string

Customer's valid date of birth

phone*

string

Customer's valid phone number

product_id*

string

This is the ID of the insurance plan.

{
   "responseCode":1,
   "responseText":"Purchase Successful",
   "data":{
      "policy":{
         "first_name":"Oleg",
         "last_name":"Stanton",
         "email":"qitaz@mailinator.com",
         "phone":"+1 (921) 845-5031",
         "dob":"2004-03-21",
         "customer_id":"196859e1-d3ab-47ad-a24d-51ea31d79378",
         "buyer_id":"196859e1-d3ab-47ad-a24d-51ea31d79378",
         "product_id":"dd81a37f-e621-4f9b-9427-5306b8a5b5e5",
         "product_category_id":"978ced0d-0e05-4de6-b43a-b408c0e8b95e",
         "distributor_id":"76d5970a-d46b-43df-beb3-8f3117b7a60f",
         "provider_id":"f029cc0c-9eb8-41b3-82b1-a9cc26fde03f",
         "activation_date":"2022-03-10",
         "start_date":"2022-03-10",
         "expiration_date":"2023-03-10T00:00:00",
         "meta":{
            "vehicle_registration_number":"akd345gf",
            "policy_number":"MOT/PM/03/22/EB/0000000212",
            "certificate_url":"http://40.87.98.47/InsuranceApiTest/Certificates/Download?moniker=zdkjsoIpn2tRNcV7eTUspA%253d%253d"
         },
         "active":true,
         "genius_price":"5000.00",
         "market_price":"5000.00",
         "profit":1000,
         "purchase_id":"a3bb4367-37e9-48ab-97d8-9ed700d47014",
         "submitted_to_provider":false,
         "id":"e120dc0d-81cf-46d2-b011-8a961eabef15",
         "created_at":"2022-03-09T12:55:43.880Z",
         "updated_at":"2022-03-09T12:55:43.880Z"
      }
   }
}
Sample Request Payload
{
  "vehicle_make": "1",
  "vehicle_model": "218",
  "address": "Surulere, Lagos",
  "insurance_start_date": "2022-12-08",
  "engine_number": "2AR0148325",
  "chassis_number": "JTMZF31V095013882",
  "vehicle_insurance_type": "Commercial",
  "vehicle_registration_number": "akd345gf",
  "first_name": "jennifer",
  "last_name": "onye",
  "email": "jenny.onye@gmail.com",
  "dob": "1994-08-28",
  "phone": "07064378577",
  "product_id": "dd81a37f-e621-4f9b-9427-5306b8a5b5e5"
}

Buy Monthly comprehensive auto insurance

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

Request Body

NameTypeDescription

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

{
    "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": "jenny.onye@gmail.com",
            "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": "jenny.onye@gmail.com",
                    "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": "jenny.onye@gmail.com",
    "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",
    "insurance_start_date": "2022-12-08",
    "engine_number": "2AR0148325",
    "chassis_number": "JTMZF31V095013882",
    "number_of_months": 1,
    "identification_image_url": "https://via.placeholder.com/300/09f/fff.png",
    "product_id": "dd81a37f-e621-4f9b-9427-5306b8a5b5e5"
}

Buy Micro comprehensive auto insurance

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

Request Body

NameTypeDescription

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

{
    "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": "jenny.onye@gmail.com",
            "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": "jenny.onye@gmail.com",
                    "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": "jenny.onye@gmail.com",
    "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",
    "insurance_start_date": "2022-12-08",
    "engine_number": "2AR0148325",
    "chassis_number": "JTMZF31V095013882",
    "number_of_months": 1,
    "identification_image_url": "https://via.placeholder.com/300/09f/fff.png",
    "product_id": "dd81a37f-e621-4f9b-9427-5306b8a5b5e5"
}

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

Auxiliary
PreviousMyCoverGeniusNextCoronation

Last updated