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