---
title: "Lists all invoice payments"
method: GET
path: "/invoice-payments"
tags: ["Invoice payments"]
---

# Lists all invoice payments

`GET /invoice-payments`

Pages every customer payment recorded against invoices across the organization, independent of which invoice it settled.
Use updated.gt and sort_by when syncing integrations; follow the pagination cursor until no next page remains.

## Query parameters

- `limit` integer
- `cursor` string — If defined, a cursor to retrieve the next page.
- `updated.gt` string, date-time
- `sort_by` 'created' | 'updated'

## Response `200`

OK

- object
  - `payments` InvoicePayment[], required
    - `id` string, uuid, required
    - `status` 'SUCCESSFUL' | 'FAILED' | 'UNCLEARED', required
    - `invoice_id` string, uuid, required
    - `amount` RoundedMonetaryAmount, required — A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
      - `amount` string, required — Monetary amount in decimal format, using a period (.) as the decimal separator. Must be rounded to the currency's default decimal places (e.g. '1.01' in USD represents 1 dollar and 1 cent).
      - `currency` string, required — Currency code following ISO-4217
    - `date` string, date
    - `account_code` string — The account code found in the Chart of Accounts
    - `updated_at` string, date-time, required — ISO 8601 timestamp in UTC timezone (must end with 'Z')
  - `pagination` Pagination, required
    - `next_cursor` string — If defined, a cursor to retrieve the next page.

## Other responses

- `default` — Error

---

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