{
"cards": [
{
"id": "3f8b2c1d-9e4a-4b7c-8d2e-1f3a5b7c9d0e",
"token": "104857321",
"company_id": "bebb185d-8210-4e66-ac63-397b49a1e09f",
"account_id": "0d6c0a2a-2b08-49bc-89a9-eb936c9ff28c",
"user_id": "29b297ca-c617-437e-9c1d-32f494fbf44d",
"type": "virtual",
"design_id": "c6d5ea1a-80f8-49ab-9fee-250d368b3915",
"status": "active",
"name": "Marketing spend",
"last_four": "4242",
"expiry_date": "2029-07-31",
"auto_convert": false,
"three_ds_biometric": false,
"spending_limit": {
"period": "monthly",
"amount": "5000.00",
"currency": "GBP",
"used": "1249.50"
},
"card_limits": {
"currency": "EUR",
"max_per_purchase": {
"amount": "250000.00"
},
"daily": {
"amount": "500000.00",
"used": "1249.50"
},
"rolling_32_days": {
"amount": "2500000.00",
"used": "8320.75"
}
},
"created_at": "2026-07-01T08:30:00Z"
}
],
"next_cursor": "eyJjIjoiMjAyNi0wNy0wMVQwODozMDowMFoiLCJpIjoiM2Y4YjJjMWQifQ"
}{
"error": "invalid spending limit: amount has more than 2 decimal places"
}List cards
Lists the company’s cards, newest first. expired and terminated cards are excluded unless requested in status.
Page with cursor (follow next_cursor) or with offset (the response then includes total and total_inactive).
Each parameter may appear once; list parameters are comma-separated.
{
"cards": [
{
"id": "3f8b2c1d-9e4a-4b7c-8d2e-1f3a5b7c9d0e",
"token": "104857321",
"company_id": "bebb185d-8210-4e66-ac63-397b49a1e09f",
"account_id": "0d6c0a2a-2b08-49bc-89a9-eb936c9ff28c",
"user_id": "29b297ca-c617-437e-9c1d-32f494fbf44d",
"type": "virtual",
"design_id": "c6d5ea1a-80f8-49ab-9fee-250d368b3915",
"status": "active",
"name": "Marketing spend",
"last_four": "4242",
"expiry_date": "2029-07-31",
"auto_convert": false,
"three_ds_biometric": false,
"spending_limit": {
"period": "monthly",
"amount": "5000.00",
"currency": "GBP",
"used": "1249.50"
},
"card_limits": {
"currency": "EUR",
"max_per_purchase": {
"amount": "250000.00"
},
"daily": {
"amount": "500000.00",
"used": "1249.50"
},
"rolling_32_days": {
"amount": "2500000.00",
"used": "8320.75"
}
},
"created_at": "2026-07-01T08:30:00Z"
}
],
"next_cursor": "eyJjIjoiMjAyNi0wNy0wMVQwODozMDowMFoiLCJpIjoiM2Y4YjJjMWQifQ"
}{
"error": "invalid spending limit: amount has more than 2 decimal places"
}Authorizations
Short-lived access token. Obtain with your api_key.
Query Parameters
Comma-separated card statuses. Defaults to every status except expired and terminated.
Card type.
virtual, physical Comma-separated UUIDs of the cardholders (max 100).
Comma-separated UUIDs of the accounts the cards spend from (max 100).
Comma-separated card tokens (max 100).
Case-insensitive match on card name or last four digits (max 100 characters).
inactive_first lists inactive cards before the rest. Defaults to newest first.
inactive_first Page size, 1–200. Defaults to 50.
1 <= x <= 200next_cursor from the previous page. Cannot be combined with offset.
Number of cards to skip. Cannot be combined with cursor.
x >= 0Response
A page of cards.