> ## Documentation Index
> Fetch the complete documentation index at: https://getlemma.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List outbound card payments

> Retrieve a paginated list of debit card payments, optionally filtered by account, card, status, or creation time.

A card payment is one purchase on a [Lemma-issued debit card](https://getlemma.com/docs/api-reference/card-payments.md#issued-debit-cards), including any refunds or reversals. Card payments are separate from [inbound card payments](https://getlemma.com/docs/api-reference/list-inbound-card-payments.md), which Lemma collects on an entity's behalf. Results are ordered by most recent first and [paginated](https://getlemma.com/docs/api-reference/pagination.md). To fetch one card payment, see [Get outbound card payment](https://getlemma.com/docs/api-reference/get-card-payment.md).

You can read all card payments paid from a bank account you have access to.

## Query parameters

**account\_id** `string`

Filter card payments to cards that spend from this bank account, prefixed with
`account_`. Cannot be combined with `card_id`. Omit both to list card payments
across every account you can access.

**card\_id** `string`

Filter card payments to one card, prefixed with `card_`. Cannot be combined
with `account_id`. Omit both to list card payments across every account you
can access.

**status** `string`

Filter card payments by status: `pending`, `posted`, `canceled`, or
`declined`. `pending` lists every payment with an authorization still open,
including ones that have partly posted.

**created\_on\_or\_after** `string`

Return only card payments whose `created_at` is on or after this time. Accepts
an [ISO 8601](https://getlemma.com/docs/api-reference/timestamps.md) timestamp (`2026-09-01T12:00:00Z`) or
a [bare date](https://getlemma.com/docs/api-reference/timestamps.md#date-only-values) (`2026-09-01`),
which covers that whole UTC day. The bound is inclusive.

**created\_on\_or\_before** `string`

Return only card payments whose `created_at` is on or before this time. Same
format and inclusivity as `created_on_or_after`.

**limit** `integer` (default: 10)

The number of card payments to return. Maximum is 100.

**cursor** `string`

Cursor from the previous response. Omit to fetch from the beginning.

## Response

**data** `object[]`

The list of card payment objects for the requested page.

**Card payment object**

**id** `string`

Unique identifier for the card payment, prefixed with `card_payment_`.

**created\_at** `string`

[ISO 8601](https://getlemma.com/docs/api-reference/timestamps.md) timestamp of when the card was first
used for this payment.

**account\_id** `string`

The bank account the card spends from.

**card\_id** `string`

The Lemma-issued debit card used for this payment. [Get
card](https://getlemma.com/docs/api-reference/get-card.md) returns the card only if your platform issued
it.

**status** `enum`

Where the payment is in its lifecycle.

**Available options**

**pending** `string`

An authorization is still open, holding funds or awaiting a refund to the
account. Part of the payment may already have posted.

**posted** `string`

Nothing is pending, and at least one element posted a transaction.

**canceled** `string`

The authorization was released or expired before anything posted, so no
money moved.

**declined** `string`

The payment was declined, so no money moved.

**merchant** `object | null`

The merchant the card paid. `null` when the card network did not report the
merchant's name, category code, and country.

**Merchant object**

**name** `string`

The merchant's name as the card network reported it, such as `AMAZON.COM`.

**category\_code** `string`

The merchant category code (MCC), the four-digit code card networks use to
classify a merchant's business.

**country** `string`

The merchant's country, as a two-letter ISO 3166-1 alpha-2 code, such as
`US` or `CA`.

**elements** `object[]`

Everything that happened to this payment, oldest first: its authorization, any
changes to it, and the settlements, refunds, or declines that followed.
Elements in the same second are listed in lifecycle order.

**Element object**

**category** `enum`

What happened. We will add values to this enum over time, so your
application should handle new values gracefully.

**Available options**

**card\_authorization** `string`

The merchant asked to hold funds, or to return them for a refund
authorization.

**card\_increment** `string`

The merchant raised an authorization.

**card\_reversal** `string`

The merchant released some or all of an authorization.

**card\_authorization\_expiration** `string`

An authorization expired before the merchant settled it.

**card\_fuel\_confirmation** `string`

A fuel pump replaced its authorization with the amount actually
pumped.

**card\_settlement** `string`

The merchant settled, and money left the account.

**card\_financial** `string`

The merchant authorized and settled in one step, as at an ATM.

**card\_refund** `string`

The merchant refunded money to the account.

**card\_decline** `string`

The payment was declined.

**created\_at** `string`

[ISO 8601](https://getlemma.com/docs/api-reference/timestamps.md) timestamp of when the card network
event happened, to the second.

**amount** `integer`

How this element changed the account, in cents, signed like a transaction
amount: negative when it holds or takes money from the account, positive
when it releases or returns money. A `card_settlement` of `-4999` posts a
transaction of `-4999`. A `card_decline` carries the amount that would
have moved.

**presentment\_amount** `integer`

This element's `amount` in the currency the merchant charged in, in the
minor unit of `presentment_currency` and signed the same way. When that
currency is not the bank account's, `presentment_amount` differs from
`amount`, which is always in the bank account's currency: a €180.00 charge
has a `presentment_amount` of `-18000` and an `amount` of what it cost in
dollars. When the currencies match, the two are equal. Absent on
`card_authorization_expiration` and `card_fuel_confirmation`, which carry
no presentment amount.

**presentment\_currency** `string`

The three-letter ISO 4217 code of the currency the merchant charged in,
such as `USD` or `EUR`. Present whenever `presentment_amount` is.

**transaction\_id** `string`

The [transaction](https://getlemma.com/docs/api-reference/get-transaction.md) this element posted.
Present on `card_settlement`, `card_financial`, and `card_refund` once the
transaction is recorded, and absent on elements that post nothing.

**has\_next** `boolean`

Whether more card payments exist after this page.

**cursor** `string | null`

Pass this value as `cursor` on the next request to fetch the following page.
`null` when this is the last page.

```json 200 theme={null}
{
  "data": [
    {
      "id": "card_payment_Tz3kRm8nVb5qWx2c",
      "created_at": "2026-10-22T13:05:48Z",
      "account_id": "account_Rv4nBt8xKw2pMh6s",
      "card_id": "card_Bx5nTm8hKw3pVd7c",
      "status": "pending",
      "merchant": {
        "name": "MAPLE SCRUBS",
        "category_code": "5699",
        "country": "US"
      },
      "elements": [
        {
          "category": "card_authorization",
          "created_at": "2026-10-22T13:05:48Z",
          "amount": -5000,
          "presentment_amount": -5000,
          "presentment_currency": "USD"
        },
        {
          "category": "card_reversal",
          "created_at": "2026-10-22T13:07:02Z",
          "amount": 1047,
          "presentment_amount": 1047,
          "presentment_currency": "USD"
        }
      ]
    },
    {
      "id": "card_payment_Hq7mTx2nRv5bKw8d",
      "created_at": "2026-10-20T14:02:11Z",
      "account_id": "account_Rv4nBt8xKw2pMh6s",
      "card_id": "card_Bx5nTm8hKw3pVd7c",
      "status": "posted",
      "merchant": {
        "name": "INTERNATIONAL HOTELS",
        "category_code": "7011",
        "country": "US"
      },
      "elements": [
        {
          "category": "card_authorization",
          "created_at": "2026-10-20T14:02:11Z",
          "amount": -10000,
          "presentment_amount": -10000,
          "presentment_currency": "USD"
        },
        {
          "category": "card_increment",
          "created_at": "2026-10-21T09:30:45Z",
          "amount": -2500,
          "presentment_amount": -2500,
          "presentment_currency": "USD"
        },
        {
          "category": "card_settlement",
          "created_at": "2026-10-22T06:15:02Z",
          "amount": -12500,
          "presentment_amount": -12500,
          "presentment_currency": "USD",
          "transaction_id": "transaction_Fh3mPq7xRv2nKt8d"
        }
      ]
    }
  ],
  "has_next": true,
  "cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0xMC0yMFQxNDowMjoxMVoiLCJpZCI6ImNhcmRfcGF5bWVudF9IcTdtVHgyblJ2NWJLdzhkIn0"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.