Skip to main content
GET
List card transactions

Authorizations

Api-Key
string
header
required

Partner API key. Must carry the cards permission.

Headers

Api-Version
string
default:2026-09.1
required

The API version this request targets. 2026-09.1. See Versioning.

Pattern: ^\d{4}-\d{2}\.\d+$

Path Parameters

customerId
string
required

An individual, a business or an employee (cus_).

Example:

"cus_1Xb7..."

Query Parameters

cardId
string

Only this card's transactions.

status
enum<string>

Filter by status.

Available options:
pending,
completed,
reversed,
declined
type
enum<string>

Filter by type.

Available options:
purchase,
refund
from
string<date-time>

From this time.

to
string<date-time>

Up to this time.

cursor
string

The nextCursor from the previous page.

limit
integer
default:20

1 to 100. Default 20.

Required range: 1 <= x <= 100

Response

The card transactions, with nextCursor and hasMore.

nextCursor
string | null

null on the last page.

hasMore
boolean