Skip to main content
GET
List card transactions
This endpoint is not paginated and takes no filters. It returns every payment recorded for the card.
These are card payments, not ledger transactions. createdAt is when the provider recorded the payment. A refund arrives as a credit, and a reversed authorisation appears as reversed rather than disappearing. For the ledger view of the same money, read transactions — card activity posts there as card.transaction.* events too.

Error codes

Authorizations

Authorization
string
header
required

A secret API key, sent as Authorization: Bearer sk_test_… in sandbox or Bearer sk_live_… in live.

Path Parameters

cardId
string
required

Card ULID. A 26-character ULID.

Required string length: 26
Pattern: ^[0-7][0-9A-HJKMNP-TV-Z]{25}$
Example:

"01K2Z3AB4C5D6E7F8G9HJKMNPQ"

Response

Successful response.

id
string
required

A 26-character ULID.

Required string length: 26
Pattern: ^[0-7][0-9A-HJKMNP-TV-Z]{25}$
Example:

"01K2Z3AB4C5D6E7F8G9HJKMNPQ"

cardId
string
required

A 26-character ULID.

Required string length: 26
Pattern: ^[0-7][0-9A-HJKMNP-TV-Z]{25}$
Example:

"01K2Z3AB4C5D6E7F8G9HJKMNPQ"

status
enum<string>
required
Available options:
pending,
completed,
failed,
reversed,
refunded
direction
enum<string>
required

A refund arrives as a credit.

Available options:
debit,
credit
amount
string
required

An integer number of the asset’s smallest unit. Use this value for arithmetic.

Pattern: ^-?\d+$
Example:

"2500000"

amountFormatted
string
required
currency
string
required
Maximum string length: 10
merchantName
string | null
required
Maximum string length: 200
merchantCountry
string | null
required
Required string length: 2
narration
string | null
required
Maximum string length: 500
createdAt
string<date-time>
required
Example:

"2026-08-14T09:00:00.000Z"