---
title: "List Invoice Payments"
method: GET
path: "/coa/api/v1/invoice-payments"
tags: ["Accounts Receivable"]
---

# List Invoice Payments

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

Retrieve a paginated list of invoice payments (payments applied against accounts
        receivable invoices), 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
- `external_id` string
- `invoice_id` integer
- `last_modified_at__gte` string
- `last_modified_at__lte` string
- `limit` integer
- `offset` integer
- `skip_count` boolean
- `voided` boolean

## Response `200`

- PaginatedInvoicePaymentSyncList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` InvoicePaymentSync[], required
    - `id` integer, required
    - `invoice_id` integer, required
    - `invoice_number` string, required
    - `amount` number, double, required
    - `currency` string, required
    - `payment_date` string, date, nullable, required
    - `payment_type` union, required — Type of payment: credit memo application, bank transaction, or manual transaction * `CREDIT_MEMO` - Credit Memo * `BANK_TRANSACTION` - Bank Transaction * `MANUAL_TRANSACTION` - Manual Transaction
      - 'CREDIT_MEMO' | 'BANK_TRANSACTION' | 'MANUAL_TRANSACTION' — * `CREDIT_MEMO` - Credit Memo * `BANK_TRANSACTION` - Bank Transaction * `MANUAL_TRANSACTION` - Manual Transaction
      - unknown
    - `source` union, required
      - 'STRIPE' | 'MANUAL' — * `STRIPE` - Stripe * `MANUAL` - Manual
      - unknown
    - `external_id` string, nullable, required — Stable upstream identifier for this payment (e.g. Stripe balance transaction 'btxn_...', Stripe credit note 'cn_...', or the mart's event external_id for customer-balance applications). Used as the natural dedup/idempotency key. Null for manually-entered payments.
    - `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/versions/6945ebc3180e/schema)