---
title: "Get actual loan payment history plus a projected remaining payment schedule. The projection is based on current balance and recorded manual payments instead of trusting the stored paymentsMade counter."
method: GET
path: "/api/v1/loans/{id}/schedule"
tags: ["loans"]
---

# Get actual loan payment history plus a projected remaining payment schedule. The projection is based on current balance and recorded manual payments instead of trusting the stored paymentsMade counter.

`GET /api/v1/loans/{id}/schedule`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/api/v1/loans/{id}/schedule`
- Auth: HTTP bearer

Get actual loan payment history plus a projected remaining payment schedule. The projection is based on current balance and recorded manual payments instead of trusting the stored paymentsMade counter.

## Path parameters

- `id` string, required

## Query parameters

- `limit` number

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object, required
    - `loan` object
      - `id` number
      - `borrowerId` string
      - `borrower` object, nullable
        - `discordId` string
        - `username` string, nullable
        - `farmName` string, nullable
        - `nickname` string, nullable
        - `image` string, nullable
        - `color` string, nullable
      - `originalAmount` number
      - `currentBalance` number
      - `apr` number
      - `term` number
      - `paymentsMade` number
      - `actualPaymentsMade` number
      - `active` boolean
      - `status` string
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
      - `lastPaymentDate` string, date-time, nullable
    - `summary` object
      - `principalPaid` number
      - `interestPaid` number
      - `paymentCount` number
      - `recordedPaymentsMade` number
      - `lastPaymentDate` string, date-time, nullable
    - `paymentHistory` object[]
      - `id` number
      - `paymentAmount` number
      - `principalAmount` number
      - `interestAmount` number
      - `balanceBefore` number
      - `balanceAfter` number
      - `paidAt` string, date-time
      - `paidBy` string
    - `upcomingPayments` object[]
      - `paymentNumber` number
      - `amount` number
      - `principal` number
      - `interest` number
      - `remainingBalance` number
  - `meta` object, required
    - `timestamp` number, required

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/farmersonly/apis/farmersonly-club-api.md) - [All operations](https://skmtc.dev/farmersonly/apis/farmersonly-club-api/llms.txt) - [OpenAPI document](https://skmtc.dev/farmersonly/apis/farmersonly-club-api/revisions/b4fa9123ba90?raw)
