GET
Repayment Schedule
Retrieve the amortized repayment schedule for an active loan.
GET/v2/loans/{loan_id}/schedule
Use this endpoint to fetch the full schedule of upcoming repayments for an active loan, including principal breakdowns, interest, and due dates. This data is essential for generating customer statements or setting up Standing Orders.
Headers
| Header | Required | Description |
|---|---|---|
Authorization | YES | Bearer token containing your secret API key. |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
loan_id | string | YES | The unique ID of the loan. |
Example Request
cURL
curl -X GET "https://sandbox.hexcore.io/v2/loans/ln_a1b2c3d4e5f6/schedule" \-H "Authorization: Bearer sk_test_your_secret_key"Example Response
JSON (200 OK)
{"status": true,"message": "Repayment schedule retrieved","data": {"loan_id": "ln_a1b2c3d4e5f6","total_repayment": 560000.00,"schedule": [ {"installment_number": 1,"due_date": "2026-06-01T00:00:00Z","principal": 41666.67,"interest": 5000.00,"total_amount_due": 46666.67,"status": "PENDING"}, {"installment_number": 2,"due_date": "2026-07-01T00:00:00Z","principal": 41666.67,"interest": 5000.00,"total_amount_due": 46666.67,"status": "PENDING"} ] } }