Skip to main content
GET
List cards

Overview

Returns a paginated list of cards issued by your business, scoped to the API key’s environment. Supports filtering by cardholder and status.
The environment is always taken from your API key — there is no environment query parameter. A SANDBOX key only returns sandbox cards; a LIVE key only returns live cards.

Query Parameters

Example

Success Response (200)

Response Fields

balance and cvv are not included in list responses. Use GET /cards/{id} to retrieve live balance and CVV for a specific card.

Error Codes

Authorizations

Authorization
string
header
required

API key from the FYATU CaaS portal. Pass as Authorization: Bearer <key>.

Query Parameters

limit
integer
default:20
Required range: 1 <= x <= 100
offset
integer
default:0
Required range: x >= 0
cardholderId
string
status
enum<string>
Available options:
ACTIVE,
FROZEN,
TERMINATED

Response

Cards retrieved

success
boolean
Example:

true

status
integer
Example:

200

message
string
Example:

"Cards retrieved"

data
object[]
pagination
object
meta
object