Tangerine

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

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

Buy Tangerine comprehensive auto insurance

Connect this endpoint to buy comprehensive auto-products from Tangerine

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

Request Body

Name	Type	Description
vehicle_make*	String	The brand of the vehicle. Head over to the auxiliary section and GET /get-vehicle-make?provider=leadway
vehicle_model*	String	The model of the vehicle. Use this endpoint /products/aiico/get-vehicle-model.
address*	string	Your valid address
vehicle_color*	String	This vehicle colour. Head over to the auxiliary section and GET /color-list
registration_number*	String	Vehicle's plate number
engine_number*	String	The vehicle's engine number
chassis_number*	String	Chasis number of the vehicle
year_of_manufacture*	String	The vehicle manufacture year.
first_name*	string	Your first name
last_name*	string	Your last name
email*	string	Your valid email address
phone_number*	string	Your valid phone number
product_id*	String	This is the ID of the insurance plan.
vehicle_cost*	Number	How much the vehicle was bought for.
premium_frequency*	String	One of [weekly, monthly, quarterly, biannually, annually]
engine_capacity*	String	The capacity of the vehicle's engine

201: Created Success Response

{
    "responseCode": 1,
    "responseText": "Purchase Successful",
    "data": {
        "policy": {
            "id": "c7fc2e27-aa30-4e08-b891-9b2e519afcb3",
            "app_mode": "test",
            "active": false,
            "first_name": "John",
            "last_name": "Doe",
            "email": "[e-mail]",
            "dob": null,
            "phone": "07114378506",
            "start_date": "2023-12-18T00:00:00.000Z",
            "expiration_date": null,
            "activation_date": "2023-12-18T00:00:00.000Z",
            "distributor_id": "10cd1dac-3a5c-43ee-b935-641d53f9cb27",
            "customer_id": "43af8e11-afbb-40ec-beb4-85486ff438f1",
            "buyer_id": "43af8e11-afbb-40ec-beb4-85486ff438f1",
            "product_id": "60a3e62c-c8a8-48e1-97a8-c385b294194e",
            "product_category_id": "978ced0d-0e05-4de6-b43a-b408c0e8b95e",
            "provider_id": "0ef7f726-19e1-438c-87aa-574ca1718726",
            "meta": {
                "payload": {
                    "email": "[e-mail]",
                    "engine_no": "PJ12345U813451P",
                    "last_name": "Doe",
                    "plan_code": "TG_PCP",
                    "first_name": "John",
                    "policy_type": "private",
                    "sum_assured": 1500000,
                    "phone_number": "07114378506",
                    "vehicle_make": "127",
                    "chasis_number": "SV30-5161226",
                    "vehicle_color": "BLACK",
                    "vehicle_model": "218",
                    "contact_address": "Surulere, Lagos",
                    "engine_capacity": 600,
                    "registration_no": "ABD-343DE",
                    "premium_frequency": "monthly",
                    "year_of_manufacture": "2013"
                },
                "vehicle_registration_number": "ABD-343DE"
            },
            "genius_price": 6875,
            "market_price": 6875,
            "purchase_id": "d85a351c-afc1-49c3-a5e5-531df4988983",
            "profit": 1375,
            "submitted_to_provider": false,
            "updated_at": "2023-12-18T12:04:10.796Z",
            "created_at": "2023-12-18T12:04:10.796Z",
            "deleted_at": null,
            "inspection_id": null
        }
    }
}

Sample Payload

{
  "first_name": "John",
  "last_name": "Doe",
  "email": "[e-mail]",
  "phone_number": "07114378506",
  "address": "Surulere, Lagos",
  "vehicle_make": "127",
  "vehicle_model": "218",
  "registration_number": "ABD-343DE",
  "engine_capacity": "600",
  "engine_number": "PJ12345U813451P",
  "chassis_number": "SV30-5161226",
  "vehicle_color": "BLACK",
  "year_of_manufacture": "2013",
  "vehicle_cost": 1500000,
  "premium_frequency": "monthly",
  "product_id": "60a3e62c-c8a8-48e1-97a8-c385b294194e"
}

Buy Tangerine third-party auto insurance

Connect this endpoint to buy third-party auto-products from Tangerine

POST https://api.mycover.ai/v1/products/tangerine/buy-thirdparty

Request Body

Name	Type	Description
vehicle_make*	String	The brand of the vehicle. Head over to the auxiliary section and GET /get-vehicle-make?provider=leadway
vehicle_model*	String	The model of the vehicle. Use this endpoint /products/aiico/get-vehicle-model.
address*	string	Your valid address
vehicle_color*	String	This vehicle colour. Head over to the auxiliary section and GET /color-list
registration_number*	String	Vehicle's plate number
engine_number*	String	The vehicle's engine number
chassis_number*	String	Chasis number of the vehicle
year_of_manufacture*	String	The vehicle manufacture year.
first_name*	string	Your first name
last_name*	string	Your last name
email*	string	Your valid email address
phone_number*	string	Your valid phone number
product_id*	String	This is the ID of the insurance plan.
engine_capacity*	String	The capacity of the vehicle's engine

201: Created Success Response

{
    "responseCode": 1,
    "responseText": "Purchase Successful",
    "data": {
        "policy": {
            "id": "932e6e43-2ac9-4eaf-ac4c-8cf57199017d",
            "app_mode": "test",
            "active": true,
            "first_name": "John",
            "last_name": "Doe",
            "email": "[e-mail]",
            "dob": null,
            "phone": "07114378506",
            "start_date": "2023-12-18T00:00:00.000Z",
            "expiration_date": "2024-12-16T00:00:00.000Z",
            "activation_date": "2023-12-18T00:00:00.000Z",
            "distributor_id": "10cd1dac-3a5c-43ee-b935-641d53f9cb27",
            "customer_id": "43af8e11-afbb-40ec-beb4-85486ff438f1",
            "buyer_id": "43af8e11-afbb-40ec-beb4-85486ff438f1",
            "product_id": "8179effb-e73b-433c-b44e-30625366d24e",
            "product_category_id": "978ced0d-0e05-4de6-b43a-b408c0e8b95e",
            "provider_id": "0ef7f726-19e1-438c-87aa-574ca1718726",
            "meta": {
                "payload": {
                    "email": "[e-mail]",
                    "engine_no": "PJ12345U123451P",
                    "last_name": "Doe",
                    "plan_code": "TG_TPP",
                    "first_name": "John",
                    "policy_type": "private",
                    "phone_number": "07114378506",
                    "vehicle_make": "1",
                    "chasis_number": "SV30-0169226",
                    "vehicle_color": "BLACK",
                    "vehicle_model": "218",
                    "contact_address": "Surulere, Lagos",
                    "engine_capacity": 1390,
                    "registration_no": "ABC-143DE",
                    "premium_frequency": "annually",
                    "year_of_manufacture": "2013"
                },
                "policy_number": "P/PMI/23/TGL/EPL5312N",
                "certificate_url": "https://3rdparty.tangerine.africa/PrintCertificateDemo.aspx?Data=P/PMI/23/TGL/EPL5312N",
                "provider_policy_id": "2dc1ecb5-8af3-494f-9e85-45526cf501c1",
                "vehicle_registration_number": "ABC-143DE"
            },
            "genius_price": 5000,
            "market_price": 5000,
            "purchase_id": "caecf67b-799d-4b00-946c-1efe140112cf",
            "profit": 1000,
            "submitted_to_provider": true,
            "updated_at": "2023-12-18T11:54:41.826Z",
            "created_at": "2023-12-18T11:54:41.826Z",
            "deleted_at": null,
            "inspection_id": null
        }
    }
}

Sample Request Payload

{
  "first_name": "John",
  "last_name": "Doe",
  "email": "[e-mail]",
  "phone_number": "07114378506",
  "address": "Surulere, Lagos",
  "vehicle_make": "1",
  "vehicle_model": "218",
  "registration_number": "ABC-143DE",
  "engine_capacity": "1390",
  "engine_number": "PJ12345U123451P",
  "chassis_number": "SV30-0169226",
  "vehicle_color": "BLACK",
  "year_of_manufacture": "2013",
  "product_id": "8179effb-e73b-433c-b44e-30625366d24e"
}

♻️ Renew Tangerine third-party auto policy

POST https://api.mycover.ai/v1/products/tangerine/renew-third-party

This endpoint renews a Tangerine third-party auto policy

Headers

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

Body

Name	Type	Description
policy_id	string	The id of the policy

Response

200

{
    "responseCode": 1,
    "responseText": "Purchase Successful",
    "data": {
        "policy": {
            "id": "932e6e43-2ac9-4eaf-ac4c-8cf57199017d",
            "app_mode": "test",
            "active": true,
            "first_name": "John",
            "last_name": "Doe",
            "email": "[e-mail]",
            "dob": null,
            "phone": "07114378506",
            "start_date": "2023-12-18T00:00:00.000Z",
            "expiration_date": "2024-12-16T00:00:00.000Z",
            "activation_date": "2023-12-18T00:00:00.000Z",
            "distributor_id": "10cd1dac-3a5c-43ee-b935-641d53f9cb27",
            "customer_id": "43af8e11-afbb-40ec-beb4-85486ff438f1",
            "buyer_id": "43af8e11-afbb-40ec-beb4-85486ff438f1",
            "product_id": "8179effb-e73b-433c-b44e-30625366d24e",
            "product_category_id": "978ced0d-0e05-4de6-b43a-b408c0e8b95e",
            "provider_id": "0ef7f726-19e1-438c-87aa-574ca1718726",
            "meta": {
                "payload": {
                    "email": "[e-mail]",
                    "engine_no": "PJ12345U123451P",
                    "last_name": "Doe",
                    "plan_code": "TG_TPP",
                    "first_name": "John",
                    "policy_type": "private",
                    "phone_number": "07114378506",
                    "vehicle_make": "1",
                    "chasis_number": "SV30-0169226",
                    "vehicle_color": "BLACK",
                    "vehicle_model": "218",
                    "contact_address": "Surulere, Lagos",
                    "engine_capacity": 1390,
                    "registration_no": "ABC-143DE",
                    "premium_frequency": "annually",
                    "year_of_manufacture": "2013"
                },
                "policy_number": "P/PMI/23/TGL/EPL5312N",
                "certificate_url": "https://3rdparty.tangerine.africa/PrintCertificateDemo.aspx?Data=P/PMI/23/TGL/EPL5312N",
                "provider_policy_id": "2dc1ecb5-8af3-494f-9e85-45526cf501c1",
                "vehicle_registration_number": "ABC-143DE"
            },
            "genius_price": 5000,
            "market_price": 5000,
            "purchase_id": "caecf67b-799d-4b00-946c-1efe140112cf",
            "profit": 1000,
            "submitted_to_provider": true,
            "updated_at": "2023-12-18T11:54:41.826Z",
            "created_at": "2023-12-18T11:54:41.826Z",
            "deleted_at": null,
            "inspection_id": null
        }
    }
}

400

{
    "responseCode": 0,
    "responseText": "An active policy must be at least 1 week to expiration.",
    "path": "/v1/products/tangerine/renew-third-party"
}

{
    "policy_id": "da5f8230-f869-4eb4-bb30-08b57ad6a292"
}

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

pageAuxiliary