---
title: "List outgoing payments. Filter server-side rather than paging and filtering client-side."
method: GET
path: "/payments"
tags: ["Payments"]
---

# List outgoing payments. Filter server-side rather than paging and filtering client-side.

`GET /payments`

## Query parameters

- `limit` string — Page size, 1–100 (default 25).
- `cursor` string — Opaque cursor from a prior response nextCursor.
- `from` string — Inclusive lower bound, YYYY-MM-DD.
- `to` string — Inclusive upper bound, YYYY-MM-DD.
- `status` 'all' | 'paid' | 'scheduled' | 'draft' | 'pending-approval' | 'canceled' — Filter by lifecycle state; defaults to all states.
- `counterparty` string — Case-insensitive substring match on the payee name. A canceled or declined payment with no saved contact reports the destination institution name instead, and is not matched by this filter.
- `method` 'ach' | 'international-wire' | 'international-wire-fee' | 'intra-transfer' | 'wire' — Payment method; wire matches domestic and international wires.
- `minAmount` string — Lower bound on the amount, in integer minor units (100000 = $1,000.00).
- `maxAmount` string — Upper bound on the amount, in integer minor units.

## Response `200`

A page of payments.

- object
  - `data` Payment[], required
    - `id` string, required
    - `status` 'paid' | 'scheduled' | 'draft' | 'pending-approval' | 'canceled' | 'declined', required
    - `counterparty` string, required
    - `amount` object, nullable, required — An amount as integer minor units plus its currency.
      - `minorUnits` integer, required — Integer minor units (e.g. cents for USD); never a float.
      - `currency` string, required — ISO 4217 currency code, e.g. "USD".
    - `method` 'ACH' | 'Wire' | 'Intra transfer' | 'International wire fee' | 'International wire' | 'null', nullable, required
    - `frequency` string, nullable, required
    - `invoiceNumber` string, nullable, required
    - `invoiceDate` string, nullable, required — ISO 8601 timestamp.
    - `dueDate` string, nullable, required — ISO 8601 timestamp.
    - `scheduledDate` string, nullable, required — ISO 8601 timestamp.
    - `sentDate` string, nullable, required — ISO 8601 timestamp.
    - `createdAt` string, nullable, required — ISO 8601 timestamp.
    - `createdBy` string, nullable, required
  - `nextCursor` string, nullable, required — Pass back as ?cursor for the next page; null on the last page.

---

[API](https://skmtc.dev/joinarc/apis/arc-api.md) · [All operations](https://skmtc.dev/joinarc/apis/arc-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/joinarc/arc-api/revisions/f0dc4aa0fe84/schema)