---
title: "Get invoice payments"
method: GET
path: "/invoices/{id}/payments"
tags: ["Invoices"]
---

# Get invoice payments

`GET /invoices/{id}/payments`

List all payments applied to a specific invoice.

## Path parameters

- `id` string, required

## Query parameters

- `by` 'id' | 'key'

## Response `200`

Payments retrieved successfully

- object
  - `data` InvoicePayment[]
    - `id` string, uuid
    - `paymentGroupId` string, uuid
    - `amount` number — Amount applied to this invoice
    - `paymentDate` string, date
    - `reference` string, nullable — Check number, transaction ID, etc.
    - `paymentMethodType` string, nullable — Payment method (check, ach_wire, 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)