List cards

{ "data": [ { "id": "3f8b2c1d-9e4a-4b7c-8d2e-1f3a5b7c9d0e", "token": "84de8ea0-e52a-4888-afd2-9d8dd5a42c20", "name": "Marketing spend", "type": "virtual", "theme": "midnight", "lastFour": "4242", "startDate": "07/26", "expiryDate": "07/29", "status": "active", "autoConvert": true, "auth3dsCredential": "otpSms", "createdAt": "2026-07-01T08:30:00.000Z", "updatedAt": "2026-07-01T08:30:00.000Z", "maxLimits": { "daily": 10000, "weekly": 50000, "monthly": 250000, "lifetime": 250000 }, "user": { "id": "29b297ca-c617-437e-9c1d-32f494fbf44d", "firstName": "Alex", "lastName": "Example", "iconUrl": "https://cdn.incard.com/avatars/29b297ca.png" }, "spendingLimit": { "type": "monthly", "amount": 5000, "amountSpent": 1249.5, "utilization": 24.99, "resetsAt": "2026-10-01T03:00:00.000Z", "isVelocityLimit": false }, "companyAccount": { "id": "0d6c0a2a-2b08-49bc-89a9-eb936c9ff28c", "name": "Main GBP account", "currencyCode": "GBP" }, "currencyCode": "GBP" } ], "meta": { "total": 1, "totalPending": 0, "totalNonPending": 1, "take": 10, "skip": 0 } }

Authorizations

Authorization

string

header

required

Short-lived access token. Obtain with your api_key.

Query Parameters

take

integer

default:10

Page size, 1–100. Defaults to 10.

Required range: 1 <= x <= 100

skip

integer

default:0

Number of cards to skip. Defaults to 0.

Required range: x >= 0

type

enum<string>

Card form factor.

Available options:

physical,

virtual

status

string

Comma-separated statuses. expired matches cards whose expiry month has passed regardless of status.

userIds

string

Comma-separated user UUIDs the cards are assigned to.

companyAccountIds

string

Comma-separated account UUIDs the cards draw from.

string

Case-insensitive match against the card name or last four digits.

includeTerminated

boolean

true includes terminated cards when no status filter is given.

sort

enum<string>

unactivatedFirst lists pending cards before the rest.

Available options:

unactivatedFirst

Response

Paginated card collection.

data

Card · object[]

required

Cards for the current page.

Show child attributes

INVOICES

ACCOUNTS

CARDS

TRANSACTIONS

Authorizations

Query Parameters

Response