Credit Life

Protect your business against your customers loan default.

Claim Credit Life

Use this end-point to lodge a claim to settle outstanding loan amounts when your customers default.

POST https://api.mycover.ai/v1/claims/credit-life

Request Body

Name	Type	Description
police_report	file	Police report document. Only required if incident was a result of an accident
policy_number*	string	Policy number
incident_type*	string	Reason for customer default ("Death", "Permanent disability", "Temporary disability", "Critical illness", "Loss of job", "Burglary")
accidental*	bolean string	Incident caused by an accident
loan_offer_date*	string	Loan offer/disbursement date
loan_repayment_date*	string	Loan repayment end date
loan_amount*	number string	Loan amount given to customer.
pending_repayment_amount*	number string	Pending repayment
loan_offer_letter*	file	Loan offer letter document
medical_report	file	Medical report required for "Death", "Permanent disability", "Temporary disability", "Critical illness"
employment_termination_letter	file	Employement termination letter required for "Loss of job"

200: OK

{
    "responseCode": 1,
    "responseText": "Claim saved successfully",
    "data": {
        "claim": {
            "id": "6e3f04bf-d992-485b-bdec-56c36d9c1a6d",
            "app_mode": "test",
            "claim_description": "Credit life claim for 5000 borrowed to Jay",
            "claim_owner": "Owner",
            "claim_owner_first_name": "Jay",
            "claim_owner_last_name": "Anaele",
            "decline_reason": "None",
            "claim_owner_email": "[e-mail]",
            "claim_owner_phone_number": "08122337787",
            "credit_life_claim_meta": {
                "loan_offer_letter": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/b633b4e6-4076-4297-86cd-f692971906bd-Screenshot%202023-02-09%20at%2017.13.18.png",
                "employment_termination_letter": null,
                "police_report": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/db3561f3-2cc9-483f-bf0f-e0fe6543f383-Screenshot%202022-12-20%20at%2011.59.55.png",
                "medical_report": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/9741354b-9db9-45db-b6ca-31acf773a49d-Screenshot%202022-12-20%20at%2012.00.06.png",
                "loan_amount": "5000",
                "pending_repayment_amount": "3000",
                "incident_type": "Death",
                "loan_offer_date": "2022-12-12",
                "loan_repayment_date": "2023-12-12",
                "accidental": "false"
            },
            "claim_type": "Credit life",
            "claim_amount": "0.00",
            "repair_estimate": "0.00",
            "offer_amount": "0.00",
            "betterment_deduction_amount": "0.00",
            "excess_deduction_amount": "0.00",
            "incident_date": null,
            "claim_status": "Pending",
            "claim_invoice_url": null,
            "offer_form_url": null,
            "created_at": "2023-03-12T22:06:23.318Z",
            "updated_at": "2023-03-12T22:08:56.938Z",
        }
    }
}
```

The incident_type parameter can only be one of the available types. The supported values are "Death", "Permanent disability", "Temporary disability", "Critical illness", "Loss of job", "Burglary".

Use form data

Sample Request Payload

{
  "policy_number": "ALZ/CL/2023/9/FFF288294",
  "loan_offer_date": "2023-08-10T14:12:38.538Z",
  "loan_repayment_date": "2023-09-10T14:12:38.538Z",
  "total_loan_amount": "200000",
  "loan_amount_paid": "100000",
  "pending_repayment_amount": "100000",
  "incident_type": "Death",
  "accidental": "true",
  "account_number": "0216316420",
  "account_name": "Omonigho Jimmy",
  "bank_code": "737",
  "bank_name": "GTB",
  "police_report": file
  "loan_offer_letter": file
  "medical_report": file
  "repayment_schedule_report": file
}

Auxiliary