mycover.ai
  • Home
  • Distributor
  • 🚀Getting Started
    • Quickstart
    • Environments
    • Authentication
    • Testing
    • Errors
    • Go Live Checklist
    • FAQs
  • 🔌Libraries & SDKs
    • Javascript
    • Vue 2
    • Vue 3
    • React
    • Flutter
    • Android
    • React Native
    • iOS
  • 📦api reference
    • Products
      • 🚘Auto
        • Aiico
        • Leadway
        • MyCoverGenius
        • Sovereign Trust
        • Coronation
        • Tangerine
        • Sanlam
      • ♥️Health
        • Hygeia
          • Hyprime Insurance
          • Hybasic Insurance
        • Bastion
          • Bastion Health
          • MediSure
        • Malaria Cover
      • 💞Personal Accident Cover
        • Aiico
        • Leadway
        • Sanlam
      • 🏠Content (Home/Office)
        • Aiico
        • Coronation
        • Sanlam
      • ✈️Travel
        • Allianz
        • Aiico
      • 💵Life Insurance
        • Credit Life
        • SME Flex
        • Flex Life
      • 🚚Goods In Transit
        • Goods In Transit (GIT)
        • Goods In Transit (GIT) On-demand
      • 💻Gadget
        • Sovereign Trust Insurance
        • Coronation
        • Tangerine
      • 🛳️Marine Insurance ✨
        • MyCoverGenius Import Marine Cover
        • Marine Cover
    • Policies
    • Claims
      • Credit Life
    • Wallet
    • Transactions
    • Customers
    • Auxiliary
      • Products
        • Bulk Purchase
  • 🧳Services
    • Webhooks
      • Validation
      • Purchase Webhook
      • Renewal Webhook
    • Messaging
Powered by GitBook
On this page
  • Buy Third-party auto insurance
  • Buy Monthly comprehensive auto insurance
  • Buy Micro comprehensive auto insurance

Was this helpful?

  1. api reference
  2. Products
  3. Auto

Sovereign Trust

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

PreviousMyCoverGeniusNextCoronation

Last updated 1 year ago

Was this helpful?

Certain properties obtain their values from supplementary endpoints. Refer to the 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

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

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

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

{
    "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

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

{
    "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 page for a list of these additional endpoints.

📦
🚘
Auxiliary
Auxiliary
Auxiliary