Skip to main content

​
List transactions

GET /v1/transactions
Returns the organization’s transactions, newest first, cursor-paginated.

​
Query parameters

ParameterTypeDescription
limitnumberMax results per page
cursorstringOpaque pagination token from the previous page’s nextCursor
agent_iduuidFilter to one agent
typestringcard or wallet
rangestring7d, 30d, 90d, or all
projectIduuidFilter to one project
teamIduuidFilter to one team

​
Response

{
  "transactions": [
    {
      "id": "…",
      "createdAt": "2026-07-10T18:22:04Z",
      "agentId": "…",
      "agentName": "Ad Spender",
      "merchant": "0x9c41…d20a",
      "amountCents": 4900,
      "currency": "USD",
      "direction": "debit",
      "rail": "wallet",
      "status": "approved",
      "purpose": "Pay for the market data API subscription",
      "denialReason": null,
      "denialCode": null,
      "onChainTxHash": "0x5b7e…",
      "chainCaip2": "eip155:8453"
    }
  ],
  "nextCursor": "2026-07-10T18:22:04.000Z|…"
}
Statuses: approved, pending, denied, failed, reversed, expired. Pass nextCursor back as cursor to fetch the next page; nextCursor is null on the last page. A malformed cursor returns 400 BAD_CURSOR.

​
Export transactions

GET /v1/transactions/export
Streams the filtered range as CSV. Accepts the same filters as the list (minus pagination), plus:
ParameterTypeDescription
statusstringapproved, pending, denied, or failed
tzstringIANA timezone for timestamps in the file (e.g. America/Los_Angeles)
Approving and denying pending transactions lives under the Approvals endpoints.