---
title: "List Bill Payments"
method: GET
path: "/coa/api/v1/bill-payments"
tags: ["Accounts Payable"]
---

# List Bill Payments

`GET /coa/api/v1/bill-payments`

Retrieve a paginated list of bill payments (payments applied against accounts
        payable bills), designed for syncing payment data into external systems.

        Results are ordered by (last_modified_at, id) ascending, so pages are stable and
        a sync can resume from where it left off.

        **Full sync (cursor pagination):**
        - Pass an empty cursor parameter (cursor=) on the first request
        - Follow the 'next' URL from each response until it is null

        **Incremental sync (time-based):**
        - Store the highest last_modified_at value you have processed
        - On the next run, pass it as last_modified_at__gte to fetch only new and updated payments

        **Voids:**
        - Voided payments are included by default with voided_date set, so integrators can
          detect payments that were reversed after a previous sync
        - Filter with voided=true or voided=false to fetch only one kind

## Query parameters

- `cursor` string
- `last_modified_at__gte` string
- `last_modified_at__lte` string
- `limit` integer
- `offset` integer
- `skip_count` boolean
- `voided` boolean

## Response `200`

- PaginatedBillPaymentSyncList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` BillPaymentSync[], required
    - `id` integer, required
    - `bill_id` integer, required
    - `bill_number` string, required
    - `amount` number, double, required
    - `currency` string, required
    - `payment_date` string, date, nullable, required
    - `source` string, nullable, required
    - `source_id` string, nullable, required
    - `voided_date` string, date, nullable, required
    - `created_at` string, date-time, required
    - `last_modified_at` string, date-time, required

---

[API](https://skmtc.net/campfire/apis/campfire-developer-apis.md) · [All operations](https://skmtc.net/campfire/apis/campfire-developer-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/campfire/campfire-developer-apis/revisions/6945ebc3180e/schema)