Skip to main content
GET
List cards

Headers

X-SUB-PARTNER-ID
string

Optional sub-partner UUID; lists that sub-partner's cards

X-API-Version
string

Selects the API version for this request, as an ISO date (YYYY-MM-DD). Omit to use the default version (2025-03-13). Supported versions: 2025-03-13, 2026-07-01, 2026-08-01, 2026-10-01, 2026-10-15.

Query Parameters

customer_id
string<uuid>

Only this customer's cards

wallet_id
string<uuid>

Only cards funded by this wallet

status
enum<string>[]

Cards in any of these statuses (comma-separated or repeated values)

Available options:
active,
frozen,
revoked,
pending_fulfillment,
pending_activation
tier
enum<string>
Available options:
standard,
premium
customer_type
enum<string>
Available options:
consumer,
business
created_after
string<date-time>

Cards created at or after this time

created_before
string<date-time>

Cards created before this time

sort_order
enum<string>

Order by creation time: "asc" for oldest first, "desc" for newest first (default)

Available options:
asc,
desc
page_size
integer<uint32>
default:10

Paging: the requested page size (max 100)

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

Paging: the cursor field from the previous page

Response

200 - application/json; charset=utf-8

PagedList

A list of items with cursors used to fetch the next or previous page

items
Card · object[]
required

The list of items

cursor
string

The cursor used to fetch the next page

prev_cursor
string

The cursor used to fetch the previous page