---
title: "Lists bill payments"
method: GET
path: "/bills/{bill_id}/payments"
tags: ["Bill Payments"]
---

# Lists bill payments

`GET /bills/{bill_id}/payments`

## Request

- Base URL: `https://api.rillet.com`
- URL: `https://api.rillet.com/bills/{bill_id}/payments`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/rillet/apis/rillet-accounting-api/docs/bills/:bill_id/payments/get.ts> (a function with typed inputs; its response is checked against the schema)

Enumerates disbursements recorded against a specific bill, useful when reconciling vendor statements to internal cash movements.
Combine with retrieve-a-bill to understand remaining balance after each payment posts.

## Path parameters

- `bill_id` string, uuid, required

## Response `200`

OK

- object
  - `payments` BillPayment[], required
    - `id` string, uuid, required
    - `status` 'CLEARED' | 'UNCLEARED', required
    - `bill_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

## Other responses

- `default`: Error

---

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