Skip to main content
GET
List transactions

Authorizations

Authorization
string
header
required

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

Headers

X-Agent-ID
string | null

Deprecated: agent identity comes from the credential. Sending this header with a party API key or user credential returns 403 agent_credential_required.

Maximum string length: 36
Pattern: ^agt_[0-9a-f]{32}$
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

type
enum<string>
default:all

Filter by transaction type.

Available options:
payment,
transfer,
all
limit
integer
default:50

Maximum results per page.

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

Cursor from the previous page.

Maximum string length: 1024
counterpartyPartyId
string

Restrict results to transactions whose payment counterparty is this party.

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

Restrict results to transactions visible through this wallet.

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

Restrict results to delegated activity performed for this customer, not activity involving it as a payment counterparty.

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

When true, return only transactions executed through an agent delegation (your connection-scoped feed).

Response

Successful Response

data
TransactionResource · object[]
required
meta
object
required