API Docs
API referenceTransactions

List transactions

GET/api/v2/transactions

Every movement on the team's accounts, newest first by createdAt, id as tie-breaker. Needs transactions:read.

Query Parameters

type?|array<>

Only transactions of this type. Repeat for several values.

status?|array<>

Only transactions in this status. Repeat for several values.

currency?|array<>

Only transactions of this account. Repeat for several values.

payoutId?string

Only transactions tied to this payout: its id (payout_…) or your customId.

createdFrom?string

Only transactions recorded at or after this time. Inclusive.

Formatdate-time
createdBefore?string

Only transactions recorded before this time. Exclusive, so windows that share a boundary do not overlap.

Formatdate-time
limit?between(1, 100)

Page size, 1 to 100. Default 20.

cursor?string

The nextCursor of the previous page. Opaque: never build or decode it.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v2/transactions"
{  "object": "list",  "data": [    {      "object": "transaction",      "id": "transaction_0e4ba886-0bfe-4b6a-ae2e-d6d9d135dd1e_out",      "type": "deposit",      "status": "pending",      "direction": "in",      "amount": "100.00",      "currency": "USD",      "payoutIds": [        "payout_0e4ba886-0bfe-4b6a-ae2e-d6d9d135dd1e"      ],      "counterpartyId": "counterparty_0e4ba886-0bfe-4b6a-ae2e-d6d9d135dd1e",      "account": {        "type": "bank_iban",        "iban": "string",        "holder": "string"      },      "reference": "string",      "txHash": "string",      "documents": [        {          "type": "self_billing_invoice",          "number": "string",          "url": "string",          "issuedAt": "string"        }      ],      "createdAt": "2026-09-24T10:00:00.000Z",      "completedAt": "2026-09-24T10:00:00.000Z"    }  ],  "hasMore": true,  "nextCursor": "string"}

Deposit test money POST

Sandbox only. Adds `amount` to the balance of the account, as a bank deposit would, and returns the account. Outside the sandbox the request fails with `SANDBOX_ONLY`. The team needs a wallet first; without one the request fails with `VERIFICATION_REQUIRED`. Needs no scope.

Get a transaction GET

Needs `transactions:read`.