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) |
{
"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": "gosoreh744@searpen.com",
"claim_owner_phone_number": "+2348098780000",
"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": "gosoreh744@searpen.com",
"phone_number": "+2348098780000"
},
"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": "gosoreh744@searpen.com",
"phone": "+2348098780000",
"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": "igr.gosoreh744@searpen.com",
"phone": "+2348098780000",
"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) |
{
"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": "gosoreh744@searpen.com",
"claim_owner_phone_number": "+2348098780000",
"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": "gosoreh744@searpen.com",
"phone_number": "+2348098780000"
},
"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": "gosoreh744@searpen.com",
"phone": "+2348098780000",
"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": "igr.gosoreh744@searpen.com",
"phone": "+2348098780000",
"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 |
Last updated