---
title: "List bill payments"
method: GET
path: "/bills/{bill_header_id}/payments-list"
tags: ["Bill Payments"]
---

# List bill payments

`GET /bills/{bill_header_id}/payments-list`

## Request

- Base URL: `http://localhost/app4legal/api/v2/money`
- URL: `http://localhost/app4legal/api/v2/money/bills/{bill_header_id}/payments-list`
- Auth: OAuth 2
  - Password
  - Token URL: `http://localhost/app4legal/api/v2/core/login`
- TypeScript: <https://skmtc.dev/app4legal/apis/a4l-money-api/docs/bills/:bill_header_id/payments-list/get.ts> (a function with typed inputs; its response is checked against the schema)

List all bill payments

## Path parameters

- `bill_header_id` integer, required

## Query parameters

- `payment_method` integer
- `total` string
- `filters` object
- `sort[asc]` 'id' | 'payment_method' | 'payment_total'
- `sort[desc]` 'id' | 'payment_method' | 'payment_total'
- `page` integer
- `per_page` integer

## Response `200`

Successful operation

- object
  - `message` string
  - `bill_payments` object[]
    - `payment_id` integer
    - `payment_voucher_id` integer
    - `payment_method` string
    - `payment_total` number, float
    - `bill_payment_total` number, float
    - `payment_reference` string, nullable
    - `description` string, nullable
    - `account_id` integer
    - `account_name` string
    - `account_currency` string
    - `account_currency_id` integer
    - `supplier_account_id` integer
    - `supplier_account_name` string
    - `date` string, date
    - `exchange_rate` number, float
    - `bill_number` string
    - `attachment` string, nullable
    - `created_on` string, date-time
    - `modified_on` string, date-time
  - `page_context` object
    - `page` integer
    - `per_page` integer
    - `next_page_url` string, nullable
    - `total` integer
    - `count` integer

## Other responses

- `401`: Unauthenticated
- `403`: Forbidden

## Changes

- **2026-08-06** `e0d144609998`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/app4legal/apis/a4l-money-api/changes/bills/:bill_header_id/payments-list/get.md)

---

[API](https://skmtc.dev/app4legal/apis/a4l-money-api.md) - [All operations](https://skmtc.dev/app4legal/apis/a4l-money-api/llms.txt) - [OpenAPI document](https://skmtc.dev/app4legal/apis/a4l-money-api/revisions/e0d144609998?raw)