Tangerine

Easily get gadget insurance from Tangerine through our convenient API

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

Buy Tangerine device policy

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

Request Body

Name

Type

Description

first_name*

String

Customer's first name

last_name*

String

Customer's last name

email*

String

Customer's email

phone_number*

String

Customer's phone number

device_value*

Number

Amount the device was bought for

gender*

String

Customer's gender

device_serial_number*

String

The device serial number

id_number*

String

Customer's means of Identity number

date_of_purchase*

String

When the device was purchased

device_type*

String

The type of device being insured. Should be one of [Phone, Laptop, Tablet, POS]

device_make*

String

The make of the device, e.g Samsung

device_model*

String

The model of the device, e.g A53

proof_of_purchase*

String

Do you have a proof of purchase like a receipt? yes/no

imei_number

String

If the device is phone, provide the IMEI

device_value*

Number

How much did you buy the device?

product_id

String

The insurance product ID

id_image_url*

String

Link to the uplaoded ID. You may use our endpoint for the file upload. See the Auxiliary section for more details.

{
    "responseCode": 1,
    "responseText": "Purchase Successful",
    "data": {
        "policy": {
            "id": "7198e617-4d22-4ae3-812f-d3840fdac51d",
            "app_mode": "test",
            "active": true,
            "first_name": "Youmi",
            "last_name": "Suiu",
            "email": "suiu@example.com",
            "dob": null,
            "phone": "07064378577",
            "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": "b9768e0f-6a65-4e16-bc5b-9c2e42b1383a",
            "buyer_id": "b9768e0f-6a65-4e16-bc5b-9c2e42b1383a",
            "product_id": "2e87194d-5eb1-48b6-8837-a9cbc78d4ec3",
            "product_category_id": "1e87194d-5eb1-48b6-8837-a9cbc78d4ec3",
            "provider_id": "0ef7f726-19e1-438c-87aa-574ca1718726",
            "meta": {
                "payload": {
                    "email": "fvd.suiu@example.com",
                    "gender": "male",
                    "id_url": "https://via.placeholder.com/300/09f/fff.png",
                    "id_number": "12345",
                    "last_name": "Suiu",
                    "first_name": "Youmi",
                    "device_make": "Samsung",
                    "device_type": "mobile_phone",
                    "imei_number": "9363653536363535",
                    "device_model": "A53",
                    "device_value": 500000,
                    "phone_number": "07064378577",
                    "date_of_purchase": "2023-05-04",
                    "proof_of_purchase": true,
                    "device_serial_number": "GDGDHDGTTWT"
                },
                "policy_number": "TG41083697",
                "certificate_url": null,
                "provider_policy_id": "26bab1bc-3af0-42a3-9c8e-28cf8ec16749"
            },
            "genius_price": 25000,
            "market_price": 25000,
            "purchase_id": "31390619-9ac1-4a53-9ffa-dbdd9a3978f4",
            "profit": 5000,
            "submitted_to_provider": true,
            "updated_at": "2023-12-18T17:39:15.541Z",
            "created_at": "2023-12-18T17:39:15.541Z",
            "deleted_at": null,
            "inspection_id": null
        }
    }
}

Sample Payload

{
  "first_name": "Youmi",
  "last_name": "Suiu",
  "email": "suiu@example.com",
  "phone_number": "07064378577",
  "gender": "Male",
  "id_number": "12345",
  "id_image_url": "https://via.placeholder.com/300/09f/fff.png",
  "device_type": "Phone",
  "device_make": "Samsung",
  "device_model": "A53",
  "imei_number": "9363653536363535",
  "device_serial_number": "GDGDHDGTTWT",
  "date_of_purchase": "2023-05-04",
  "proof_of_purchase": "yes",
  "device_value": 500000,
  "product_id": "2e87194d-5eb1-48b6-8837-a9cbc78d4ec3"
}

♻️ Renew Tangerine device policy

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

This endpoint renews a Tangerine device 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

{
    "responseCode": 1,
    "responseText": "Renewal Successful",
    "data": {
        "policy": {
            "id": "da5f8230-f869-4eb4-bb30-08b57ad6a292",
            "app_mode": "test",
            "first_name": "Youmi",
            "last_name": "Suiu",
            "email": "glitzyken17@gmail.com",
            "phone": "07064378577",
            "dob": null,
            "product_category_id": "1e87194d-5eb1-48b6-8837-a9cbc78d4ec3",
            "activation_date": "2024-02-09T00:00:00.000Z",
            "start_date": "2024-02-07T00:00:00.000Z",
            "expiration_date": "2025-02-20T00:00:00.000Z",
            "market_price": 15000,
            "genius_price": 15000,
            "profit": 3000,
            "meta": {
                "payload": {
                    "first_name": "Youmi",
                    "last_name": "Suiu",
                    "email": "tjd.glitzyken17@gmail.com",
                    "phone_number": "09135104478",
                    "gender": "male",
                    "id_number": "22345",
                    "id_url": "https://via.placeholder.com/300/09f/fff.png",
                    "device_type": "mobile_phone",
                    "device_make": "Samsung",
                    "device_model": "A54",
                    "imei_number": "3963653536363535",
                    "proof_of_purchase": false,
                    "date_of_purchase": "2023-05-04",
                    "device_value": 300000,
                    "device_serial_number": "GDGDHDGTTWZ"
                },
                "policy_number": "TG39877023",
                "certificate_url": null,
                "provider_policy_id": "899338eb-9093-432d-87db-29e264c4770d"
            },
            "active": true,
            "submitted_to_provider": true,
            "created_at": "2024-02-09T22:20:28.248Z",
            "updated_at": "2024-02-22T10:57:47.337Z",
            "deleted_at": null,
            "product_id": "2e87194d-5eb1-48b6-8837-a9cbc78d4ec3",
            "customer_id": "a335e043-cfa8-4049-853a-a47d89813ea2",
            "buyer_id": "a335e043-cfa8-4049-853a-a47d89813ea2",
            "distributor_id": "10cd1dac-3a5c-43ee-b935-641d53f9cb27",
            "provider_id": null,
            "inspection_id": null,
            "purchase_id": "fa373285-8bab-4963-a059-3669ea5d0e0c",
            "customer": {
                "first_name": "Oluwaseun",
                "last_name": "Dabiri",
                "email": "glitzyken17@gmail.com",
                "phone_number": "09135104478",
                "id": "a335e043-cfa8-4049-853a-a47d89813ea2"
            },
            "product": {
                "name": "Tangerine Device Insurance",
                "description": "Tangerine Device Insurance",
                "id": "2e87194d-5eb1-48b6-8837-a9cbc78d4ec3",
                "inspectable": false,
                "is_dynamic_pricing": true,
                "claimable": true,
                "route_name": "tangerine-device-cover",
                "productCategory": {
                    "id": "1e87194d-5eb1-48b6-8837-a9cbc78d4ec3",
                    "name": "Gadget"
                }
            },
            "distributor": {
                "business_name": "KenBiz",
                "id": "10cd1dac-3a5c-43ee-b935-641d53f9cb27"
            },
            "provider": null,
            "purchase": {
                "id": "fe52b96c-42f7-467d-9e93-7c6205952f3f",
                "total": "15000"
            },
            "inspection": null
        }
    }
}

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

Sample payload

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

PreviousCoronation NextMarine Insurance ✨

Last updated 11 months ago

Was this helpful?