Accounts

List transactions

Get a policy-gated account transaction history.

GET/v1/agent-api/accounts/{id}/transactions

Path parameters

idstringRequired

Query parameters

startstringOptional
endstringOptional
Inclusive upper bound; must be on or after start when both are provided
limitintegerOptional
offsetintegerOptional

Responses

200
Account transaction history
403
Account not accessible under this policy
404
Readable account not found

Response fields

accountIdstringRequired
transactionsarray of objectRequired
transactions[].idstringRequired
transactions[].type"operator-send" | "operator-transfer" | "operator-deposit" | "operator-refund" | "microdeposit"Required
transactions[].actionstringRequired
transactions[].status"pending" | "processing" | "completed" | "failed" | "reversed"Required
transactions[].movementStatus"initiated" | "provider_pending" | "processing" | "completed" | "failed" | "reversed" | "manual_review"Required
transactions[].direction"incoming" | "outgoing"Required
transactions[].amountmoneyRequired
USD amount. With tokenDetails, the settled recipient credit, or zero for a movement within the same account. Otherwise the recorded transaction amount.
transactions[].feemoneyRequired
With tokenDetails, the net account debit beyond amount, in USD at par, including fees, conversion cost and customer-paid gas. A negative value is a net conversion credit. Otherwise the recorded Catena fee.
transactions[].tokenDetailsobjectOptional
Optional settled token detail for this account. Primary amounts are USD at par; balance holdings use the same asset vocabulary. Omitted when token provenance is unavailable or the organization has no held-asset entitlement.
transactions[].currencystringRequired
transactions[].networkstringOptional
transactions[].counterpartyNamestringOptional
transactions[].method"ach" | "wire" | "on-chain"Optional
transactions[].memostringOptional
transactions[].descriptionstringOptional
transactions[].txHashstringOptional
transactions[].createdAtstringRequired
transactions[].completedAtstringOptional
totalnumberRequired
Updated October 29, 2026 Generated from the agent API's published OpenAPI document View as Markdown