Skip to main content
GET
List transactions
Every charge on your company’s cards and every Vault checkout your agents opened, newest first, in your credential’s mode. To read everything, keep passing the cursor from each page until has_more is false. A charge that lands while you page never shifts or repeats a row. A card_id or user_id that isn’t yours reads as an empty list, the same as one with no transactions yet.

Authorizations

Authorization
string
header
required

A platform access token. Get one on the Create an access token endpoint by exchanging your client_id + client_secret, then send it as Authorization: Bearer <token>. Tokens live one hour.

Query Parameters

limit
integer
default:50

Rows per page, 1 to 100. Defaults to 50.

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

The cursor from the previous page. Leave it out for the newest rows.

status
enum<string>

Only transactions in this status.

Available options:
pending,
authorized,
cleared,
declined,
voided,
refunded
card_id
string

Only charges on this card. Leaves Vault checkouts out, since they aren't on a card of yours.

user_id
string

Only this user's transactions.

created_after
string<date-time>

Only transactions at or after this ISO 8601 time.

created_before
string<date-time>

Only transactions before this ISO 8601 time.

Response

One page of transactions.

object
enum<string>
required

Always list.

Available options:
list
data
object[]
required
cursor
string | null
required

Pass it as cursor to read the next page. Null on the last page.

has_more
boolean
required

Whether another page follows.