Get card

{ "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" }

Authorizations

Authorization

string

header

required

Short-lived access token. Obtain with your api_key.

Path Parameters

string

required

Card UUID.

Response

The card.

A card with its assigned user, linked account, and spending limit, as returned by the v2 card endpoints.

string

required

Card UUID. Use this in card action endpoints.

token

string

required

Card token. Matches card_token on transactions and the card_tokens transaction filter.

name

string

required

Card name.

type

enum<string>

required

Form factor.

Available options:

physical,

virtual

lastFour

string

required

Last four digits of the card number.

startDate

string

required

Valid-from month as MM/YY.

expiryDate

string

required

Expiry month as MM/YY.

status

enum<string>

required

Card status. pending cards await activation; frozen cards were frozen by a team member; blocked cards were blocked by Incard.

Available options:

pending,

active,

frozen,

blocked,

closing,

terminated

autoConvert

boolean

required

Whether spend in other currencies is auto-converted from the linked account.

auth3dsCredential

enum<string>

required

3-D Secure challenge method.

Available options:

otpSms,

otpSmsPlusBiometric

createdAt

string<date-time>

required

updatedAt

string<date-time>

required

maxLimits

object

required

Maximum spending limit that can be set for each period. null where no maximum applies.

Show child attributes

user

object | null

required

User the card is assigned to, or null.

Show child attributes

spendingLimit

object

required

Current spending limit. When no limit is configured a default monthly velocity limit is reported with isVelocityLimit: true.

Show child attributes

companyAccount

object | null

required

Account the card draws from, or null.

Show child attributes

currencyCode

string

required

Currency of the linked account, falling back to the company base currency.

theme

string | null

(Optional) Visual theme identifier.

INVOICES

ACCOUNTS

CARDS

TRANSACTIONS

Authorizations

Path Parameters

Response