Skip to main content
GET
List card transactions

Authorizations

Authorization
string
header
required

Bearer authentication: send your API key, agent key, or OAuth access token as Authorization: Bearer <credential>.

Headers

X-Instance-ID
string | null

Caller-chosen identifier for the agent run, session, or conversation, required when an agent moves money.

Maximum string length: 1024

Query Parameters

limit
integer
default:50

Maximum results per page.

Required range: 1 <= x <= 100
cursor
string

Cursor from the previous page.

Maximum string length: 1024
walletId
string

Only card transactions on this wallet (wal_*).

Pattern: ^wal_[0-9a-f]{32}$
cardId
string

Only card transactions on this card (pcd_*).

Pattern: ^pcd_[0-9a-f]{32}$
agentId
string

Only card transactions this agent made (agt_*).

Pattern: ^agt_[0-9a-f]{32}$
status
enum<string>

Only card transactions in this status.

Available options:
pending,
authorized,
partially_captured,
captured,
reversed,
declined,
refunded
createdAfter
string

Only card transactions that happened after this RFC 3339 timestamp.

Maximum string length: 64
Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$
createdBefore
string

Only card transactions that happened before this RFC 3339 timestamp.

Maximum string length: 64
Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$
customerPartyId
string

Customer party to act for (pty_*). Omit to read your own party's card transactions. To read a connected customer's, pass its ID; you need the customer's cards.read grant.

Pattern: ^pty_[0-9a-f]{32}$

Response

Successful Response

data
CardTransactionResource · object[]
required
meta
object
required