---
title: "Get bill payments"
method: GET
path: "/bills/{id}/payments"
tags: ["Bills"]
---

# Get bill payments

`GET /bills/{id}/payments`

List all payments applied to a specific bill.

## Path parameters

- `id` string, required

## Query parameters

- `by` 'id' | 'key'

## Response `200`

Payments retrieved successfully

- object
  - `data` BillPaymentApplied[]
    - `id` string, uuid
    - `paymentGroupId` string, uuid
    - `amount` number — Amount applied to this bill
    - `paymentDate` string, date
    - `reference` string, nullable — Check number, transaction ID, etc.
  - `totalPaid` number
  - `openBalance` number

## Other responses

- `401` — Unauthorized - invalid or missing access token
- `404` — Resource not found

---

[API](https://skmtc.net/mvmnt/apis/mvmnt-api.md) · [All operations](https://skmtc.net/mvmnt/apis/mvmnt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mvmnt/mvmnt-api/versions/c44e5e7a4256/schema)