---
title: "Get active loan schedule"
method: GET
path: "/api/v1/loan-accounts/{id}/schedule"
tags: ["Loan Accounts"]
---

# Get active loan schedule

`GET /api/v1/loan-accounts/{id}/schedule`

Returns ordered active loan installment schedule entries. A malformed UUID yields 422, distinct from 404.

## Path parameters

- `id` string, uuid, required — Loan account identifier (UUID).

## Response `200`

OK

- ActiveLoanScheduleHumaBody
  - `data` ActiveLoanScheduleEntryHumaBody[], nullable, required — Installment schedule entries ordered by installment number.
    - `dueDate` string, required — ISO-8601 installment due date.
    - `feesAmount` string, required — Fees component (2 d.p. string).
    - `installmentNumber` integer, required — 1-based installment sequence number.
    - `interestAmount` string, required — Interest component (2 d.p. string).
    - `penaltiesAmount` string, required — Penalties component (2 d.p. string).
    - `principalAmount` string, required — Principal component (2 d.p. string).
    - `status` string, required — Installment status (e.g. upcoming, due, paid).
    - `totalAmount` string, required — Total installment amount (2 d.p. string).
  - `jurisdictionCode` string, required — ISO 3166-1 jurisdiction code the account operates under (e.g. BR).
  - `profileVersion` string, required — Product profile version applied to this account.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)