---
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`

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

---

[API](https://skmtc.net/app4legal/apis/a4l-money-api.md) · [All operations](https://skmtc.net/app4legal/apis/a4l-money-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/app4legal/a4l-money-api/revisions/e0d144609998/schema)