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.

201: Created

{
    "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": "[e-mail]",
            "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": "[e-mail]",
                    "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": "[e-mail]",
  "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

200

{
    "responseCode": 1,
    "responseText": "Renewal Successful",
    "data": {
        "policy": {
            "id": "da5f8230-f869-4eb4-bb30-08b57ad6a292",
            "app_mode": "test",
            "first_name": "Youmi",
            "last_name": "Suiu",
            "email": "[e-mail]",
            "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": "[e-mail]",
                    "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": "[e-mail]",
                "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
        }
    }
}

400

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