Skip to content
rigid.fi

List cards

GET/v1/cards

Requires an API client bearer token.

Lists cards for the authenticated tenant. Newest first; cursor-paginated (pass the last row's id as starting_after). Optionally narrowed to one cardholder via cardholder_id, or to one programme via programme_id. Alternatively, pass ids (comma-separated, 1..100) for a batch-get by id; ids and starting_after are mutually exclusive.

Parameters

Query parameters

NameRequiredDescription
cardholder_idoptional
programme_idoptional
idsoptional
limitoptional
starting_afteroptional

Example

curl https://api.rigid.fi/v1/cards \
  -H "Authorization: Bearer $RIGID_API_TOKEN"

Responses

200

A page of cards.

dataarray of objectrequired
+ show properties
idstring (uuid)required
programme_idstring (uuid)required
card_product_idstring (uuid)required
cardholder_idstring (uuid)required
pan_refstringrequired
last4stringrequired
iinstringrequired
exp_monthintegerrequired
exp_yearintegerrequired
state"unactivated" | "active" | "suspended" | "terminated" | "lost" | "stolen"required
controlsarray of one ofrequired
+ show properties

One of

mcc_allow

kind"mcc_allow"required
valuesarray of stringrequired

mcc_deny

kind"mcc_deny"required
valuesarray of stringrequired

country_allow

kind"country_allow"required
valuesarray of stringrequired

country_deny

kind"country_deny"required
valuesarray of stringrequired

channel_allow

kind"channel_allow"required
valuesarray of stringrequired

channel_deny

kind"channel_deny"required
valuesarray of stringrequired

per_txn_cap

kind"per_txn_cap"required
amountstringrequired

per_day_cap

kind"per_day_cap"required
countintegerrequired

per_day_amount_cap

kind"per_day_amount_cap"required
amountstringrequired
funding_account_idstring | nullrequired
cvk_generationstringrequired
created_atstringrequired
currency"EUR" | "GBP" | "USD"required
cardholder_namestringrequired
cardholder_emailstringrequired
has_morebooleanrequired
next_cursorstring (uuid) | nullrequired
400

Validation error

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
401

Authentication required

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
403

Forbidden

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
500

Internal server error

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring