Claims

We are offering an automated process to take the stress out of the traditional claim processing and settlement.

This means, with our responsive Claims Tracking API, no manual process is involved while you seamlessly track and monitor the claim status between customers and providers.

Our status endpoint enables our server to respond with the claim details and status of the specified claim reference.

View Claims

See a list of all the claims made by your customers and your providers’ response on your integration.

GET https://staging.api.mycover.ai/v1/claims

Query Parameters

Name	Type	Description
page	string	Page number of the response (in batches of 10)
limit	string	Number of claims to display per batch (default is 10)

200: OK

{
    "responseCode": 1,
    "responseText": "Claims retrieved",
    "data": {
        "claims": [
            {
                "id": "63359807-f6c2-463b-bd52-a58179169fb1",
                "app_mode": "test",
                "claim_description": "The phone fell off my pocket while crushing on a bike.",
                "claim_owner": "Owner",
                "claim_owner_first_name": "captain",
                "claim_owner_last_name": "general",
                "decline_reason": "None",
                "claim_owner_email": "[e-mail]",
                "claim_owner_phone_number": "[phone]",
                "vehicle_claim_meta": null,
                "gadget_claim_meta": {
                    "date": "2023-09-08",
                    "time": "22:53",
                    "address": "ojodu lagos",
                    "bank_code": "044",
                    "bank_name": "Test Bank",
                    "back_image": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/7bd6574b-7f2b-4b16-912d-185de888d2f8-iPHONE_14_back.webp",
                    "side_image": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/bdd4cb5b-450e-4b08-87e0-00c3e5b00cbf-iphone-14-side.webp",
                    "description": "The phone fell off my pocket while crushing on a bike.",
                    "front_image": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/f3bdd2c6-c4d8-4cc1-8946-b7ffad7c5cdc-iphone-14-front.webp",
                    "account_name": "TEST-MANAGED-ACCOUNT",
                    "incident_type": "Screen damage",
                    "police_report": null,
                    "policy_number": "ACC/AR/9/23/HQ/5300",
                    "account_number": "1238008997",
                    "cost_of_repair": "60000",
                    "repair_receipt": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/584e5605-4f2b-4c80-8fb4-f4318948b41a-man1.jpg",
                    "payment_receipt": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/11b73219-90d9-47ef-85ac-4835a90e8d10-Land-Rover_Range_Rover.jpeg",
                    "status_time_line": [
                        {
                            "name": "Pending",
                            "time_stamp": "Sep 10, 2023 9:54 PM"
                        },
                        {
                            "name": "Approved",
                            "time_stamp": "Sep 11, 2023 3:36 AM"
                        },
                        {
                            "name": "Offer sent",
                            "time_stamp": "Sep 11, 2023 3:54 AM"
                        },
                        {
                            "name": "Offer accepted",
                            "time_stamp": "Sep 11, 2023 3:55 AM"
                        },
                        {
                            "name": "Paid",
                            "time_stamp": "Sep 11, 2023 3:55 AM"
                        }
                    ]
                },
                "credit_life_claim_meta": null,
                "claim_type": "Gadget",
                "claim_amount": "60000.00",
                "estimate_amount": "60000.00",
                "offer_amount": "60000.00",
                "betterment_deduction_amount": "0.00",
                "excess_deduction_amount": "0.00",
                "incident_date": null,
                "claim_status": "Paid",
                "claim_invoice_url": null,
                "offer_form_url": null,
                "created_at": "2023-09-10T20:54:06.656Z",
                "updated_at": "2023-09-11T02:55:49.197Z",
                "deleted_at": null,
                "product_id": "ffb0711c-1e4a-453b-a26c-2726e0a1a7bb",
                "customer_id": "0f15d90a-07fd-4e89-b74f-e12776c7a6ab",
                "distributor_id": "92e39bc5-6110-4dcb-8583-bc50c2e6922b",
                "claim_id": null,
                "provider_id": "0ef7f726-19e1-438c-87aa-574ca1718726",
                "policy_id": "4a72e42c-0493-4511-9978-e8934c3d5a88",
                "inspection_id": null,
                "customer": {
                    "id": "0f15d90a-07fd-4e89-b74f-e12776c7a6ab",
                    "first_name": "captain",
                    "last_name": "general",
                    "email": "[e-mail]",
                    "phone_number": "[phone]"
                },
                "provider": {
                    "id": "0ef7f726-19e1-438c-87aa-574ca1718726",
                    "company_name": "MyCoverGenius"
                },
                "product": {
                    "id": "ffb0711c-1e4a-453b-a26c-2726e0a1a7bb",
                    "route_name": "mcg-gadget-cover",
                    "name": "MyCoverGenius Gadget Cover"
                },
                "policy": {
                    "id": "4a72e42c-0493-4511-9978-e8934c3d5a88",
                    "app_mode": "test",
                    "first_name": "captain",
                    "last_name": "general",
                    "email": "[e-mail]",
                    "phone": "[phone]",
                    "dob": "1986-02-09",
                    "product_category_id": "1e87194d-5eb1-48b6-8837-a9cbc78d4ec3",
                    "activation_date": "2023-09-10T20:06:01.000Z",
                    "start_date": "2023-09-10T20:06:01.000Z",
                    "expiration_date": "2024-09-08T23:00:00.000Z",
                    "market_price": 6200,
                    "genius_price": 6200,
                    "profit": 1240,
                    "meta": {
                        "payload": {
                            "dob": "1986-02-09",
                            "color": "gray",
                            "email": "[e-mail]",
                            "phone": "[phone]",
                            "gender": "male",
                            "address": "capm david",
                            "id_image": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/ced894a4-329a-46a2-bd8b-dcb5bef09ee0-dummy-employee.png",
                            "imei_one": "78765435678989",
                            "last_name": "general",
                            "first_name": "captain",
                            "product_id": 5,
                            "owner_title": "Chief",
                            "gadget_value": 155000,
                            "model_number": "HG6446787D",
                            "serial_number": "86544567898765",
                            "gadget_brand_id": 1,
                            "gadget_model_id": 1,
                            "policy_start_date": "2023-09-09T20:06:01.047Z",
                            "gadget_category_id": 1,
                            "payment_interval_id": 1,
                            "about_device_screenshot": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/561ff1ff-e9e6-4f33-bab9-6830d52988eb-hygeia.jpeg"
                        },
                        "policy_number": "ACC/AR/9/23/HQ/5300",
                        "certificate_url": "https://covergenius.s3.eu-west-2.amazonaws.com/staging_policy_documents/policy_ACC/AR/9/23/HQ/530019930.pdf",
                        "provider_policy_id": 19930,
                        "device_serial_number": "86544567898765"
                    },
                    "active": true,
                    "submitted_to_provider": true,
                    "created_at": "2023-09-09T20:06:02.054Z",
                    "updated_at": "2023-09-09T20:06:32.568Z",
                    "deleted_at": null,
                    "product_id": "ffb0711c-1e4a-453b-a26c-2726e0a1a7bb",
                    "customer_id": "0f15d90a-07fd-4e89-b74f-e12776c7a6ab",
                    "buyer_id": "0f15d90a-07fd-4e89-b74f-e12776c7a6ab",
                    "distributor_id": "92e39bc5-6110-4dcb-8583-bc50c2e6922b",
                    "provider_id": "0ef7f726-19e1-438c-87aa-574ca1718726",
                    "inspection_id": null,
                    "purchase_id": "6b72c80e-7417-4456-9d65-3e697a70207d"
                },
                "inspection": null,
                "comments": []
            },
            {
                "id": "82951ec2-09c2-4037-8ee0-8f1a40aefcbf",
                "app_mode": "test",
                "claim_description": "Credit life claim for 250000 borrowed to John",
                "claim_owner": "Owner",
                "claim_owner_first_name": "John"

Search Claim

You can search and find claims using any of the following queries as strings;

GET https://staging.api.mycover.ai/v1/claims/search

Query Parameters

Name	Type	Description
status	string	Filter claims by status (Viewed, Pending, Inspection submitted, Approved, Declined, Reviewing, Repair estimate submitted, Offer sent, Offer accepted, Offer rejected, Paid, Settled)
incident_start_date	string	View claims by the incident start date
incident_end_date	string	View claims by the incident end date
customer_id	string	View claims by your customer ID
customer_email	string	View claims by your customer email
first_name	string	View claims by customer’s first name
last_name	string	View claims by customer’s last name
phone_number	string	View claims by customer’s phone number
claim_type	string	Search by type of claim
claim_owner	string	View claims by third parties’ name
claim_amount	string	View claims by the amount your customer wants
offer_amount	string	View claims by amount offered to your customers
repair_estimate	string	View claims by estimate of repairs
page	string	Page number of the response (in batches of 10)
limit	string	Number of filtered claims to display per batch (default is 10)

200: OK

{
    "responseCode": 1,
    "responseText": "Claims retrieved",
    "data": {
        "claims": [
            {
                "id": "63359807-f6c2-463b-bd52-a58179169fb1",
                "app_mode": "test",
                "claim_description": "The phone fell off my pocket while crushing on a bike.",
                "claim_owner": "Owner",
                "claim_owner_first_name": "captain",
                "claim_owner_last_name": "general",
                "decline_reason": "None",
                "claim_owner_email": "[e-mail]",
                "claim_owner_phone_number": "[phone]",
                "vehicle_claim_meta": null,
                "gadget_claim_meta": {
                    "date": "2023-09-08",
                    "time": "22:53",
                    "address": "ojodu lagos",
                    "bank_code": "044",
                    "bank_name": "Test Bank",
                    "back_image": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/7bd6574b-7f2b-4b16-912d-185de888d2f8-iPHONE_14_back.webp",
                    "side_image": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/bdd4cb5b-450e-4b08-87e0-00c3e5b00cbf-iphone-14-side.webp",
                    "description": "The phone fell off my pocket while crushing on a bike.",
                    "front_image": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/f3bdd2c6-c4d8-4cc1-8946-b7ffad7c5cdc-iphone-14-front.webp",
                    "account_name": "TEST-MANAGED-ACCOUNT",
                    "incident_type": "Screen damage",
                    "police_report": null,
                    "policy_number": "ACC/AR/9/23/HQ/5300",
                    "account_number": "1238008997",
                    "cost_of_repair": "60000",
                    "repair_receipt": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/584e5605-4f2b-4c80-8fb4-f4318948b41a-man1.jpg",
                    "payment_receipt": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/11b73219-90d9-47ef-85ac-4835a90e8d10-Land-Rover_Range_Rover.jpeg",
                    "status_time_line": [
                        {
                            "name": "Pending",
                            "time_stamp": "Sep 10, 2023 9:54 PM"
                        },
                        {
                            "name": "Approved",
                            "time_stamp": "Sep 11, 2023 3:36 AM"
                        },
                        {
                            "name": "Offer sent",
                            "time_stamp": "Sep 11, 2023 3:54 AM"
                        },
                        {
                            "name": "Offer accepted",
                            "time_stamp": "Sep 11, 2023 3:55 AM"
                        },
                        {
                            "name": "Paid",
                            "time_stamp": "Sep 11, 2023 3:55 AM"
                        }
                    ]
                },
                "credit_life_claim_meta": null,
                "claim_type": "Gadget",
                "claim_amount": "60000.00",
                "estimate_amount": "60000.00",
                "offer_amount": "60000.00",
                "betterment_deduction_amount": "0.00",
                "excess_deduction_amount": "0.00",
                "incident_date": null,
                "claim_status": "Paid",
                "claim_invoice_url": null,
                "offer_form_url": null,
                "created_at": "2023-09-10T20:54:06.656Z",
                "updated_at": "2023-09-11T02:55:49.197Z",
                "deleted_at": null,
                "product_id": "ffb0711c-1e4a-453b-a26c-2726e0a1a7bb",
                "customer_id": "0f15d90a-07fd-4e89-b74f-e12776c7a6ab",
                "distributor_id": "92e39bc5-6110-4dcb-8583-bc50c2e6922b",
                "claim_id": null,
                "provider_id": "0ef7f726-19e1-438c-87aa-574ca1718726",
                "policy_id": "4a72e42c-0493-4511-9978-e8934c3d5a88",
                "inspection_id": null,
                "customer": {
                    "id": "0f15d90a-07fd-4e89-b74f-e12776c7a6ab",
                    "first_name": "captain",
                    "last_name": "general",
                    "email": "[e-mail]",
                    "phone_number": "[phone]"
                },
                "provider": {
                    "id": "0ef7f726-19e1-438c-87aa-574ca1718726",
                    "company_name": "MyCoverGenius"
                },
                "product": {
                    "id": "ffb0711c-1e4a-453b-a26c-2726e0a1a7bb",
                    "route_name": "mcg-gadget-cover",
                    "name": "MyCoverGenius Gadget Cover"
                },
                "policy": {
                    "id": "4a72e42c-0493-4511-9978-e8934c3d5a88",
                    "app_mode": "test",
                    "first_name": "captain",
                    "last_name": "general",
                    "email": "[e-mail]",
                    "phone": "[phone]",
                    "dob": "1986-02-09",
                    "product_category_id": "1e87194d-5eb1-48b6-8837-a9cbc78d4ec3",
                    "activation_date": "2023-09-10T20:06:01.000Z",
                    "start_date": "2023-09-10T20:06:01.000Z",
                    "expiration_date": "2024-09-08T23:00:00.000Z",
                    "market_price": 6200,
                    "genius_price": 6200,
                    "profit": 1240,
                    "meta": {
                        "payload": {
                            "dob": "1986-02-09",
                            "color": "gray",
                            "email": "[e-mail]",
                            "phone": "[phone]",
                            "gender": "male",
                            "address": "capm david",
                            "id_image": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/ced894a4-329a-46a2-bd8b-dcb5bef09ee0-dummy-employee.png",
                            "imei_one": "78765435678989",
                            "last_name": "general",
                            "first_name": "captain",
                            "product_id": 5,
                            "owner_title": "Chief",
                            "gadget_value": 155000,
                            "model_number": "HG6446787D",
                            "serial_number": "86544567898765",
                            "gadget_brand_id": 1,
                            "gadget_model_id": 1,
                            "policy_start_date": "2023-09-09T20:06:01.047Z",
                            "gadget_category_id": 1,
                            "payment_interval_id": 1,
                            "about_device_screenshot": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/561ff1ff-e9e6-4f33-bab9-6830d52988eb-hygeia.jpeg"
                        },
                        "policy_number": "ACC/AR/9/23/HQ/5300",
                        "certificate_url": "https://covergenius.s3.eu-west-2.amazonaws.com/staging_policy_documents/policy_ACC/AR/9/23/HQ/530019930.pdf",
                        "provider_policy_id": 19930,
                        "device_serial_number": "86544567898765"
                    },
                    "active": true,
                    "submitted_to_provider": true,
                    "created_at": "2023-09-09T20:06:02.054Z",
                    "updated_at": "2023-09-09T20:06:32.568Z",
                    "deleted_at": null,
                    "product_id": "ffb0711c-1e4a-453b-a26c-2726e0a1a7bb",
                    "customer_id": "0f15d90a-07fd-4e89-b74f-e12776c7a6ab",
                    "buyer_id": "0f15d90a-07fd-4e89-b74f-e12776c7a6ab",
                    "distributor_id": "92e39bc5-6110-4dcb-8583-bc50c2e6922b",
                    "provider_id": "0ef7f726-19e1-438c-87aa-574ca1718726",
                    "inspection_id": null,
                    "purchase_id": "6b72c80e-7417-4456-9d65-3e697a70207d"
                },
                "inspection": null,
                "comments": []
            },
            {
                "id": "82951ec2-09c2-4037-8ee0-8f1a40aefcbf",
                "app_mode": "test",
                "claim_description": "Credit life claim for 250000 borrowed to John",
                "claim_owner": "Owner",
                "claim_owner_first_name": "John"

Get Claim Details

Get specific claim details of a customer using a unique claim ID

GET https://staging.api.mycover.ai/v1/claims/{claim_id}

Path Parameters

Name	Type	Description
claim_id*	string	ID of the claim you want to view