Skip to main content
GET
/
cards
List Cards
curl --request GET \
  --url https://api.fyatu.com/api/v3/cards \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "message": "Cards retrieved successfully",
  "data": {
    "cards": [
      {
        "id": "crd_8f3a2b1c4d5e6f7890abcdef12345678",
        "cardholderId": "ch_1a2b3c4d5e6f7890abcdef1234567890",
        "name": "JAMES WILSON",
        "last4": "4829",
        "maskedNumber": "****4829",
        "expiryDate": "09/2028",
        "brand": "MASTERCARD",
        "status": "ACTIVE",
        "isReloadable": true,
        "createdAt": "2026-01-10 14:30:00"
      },
      {
        "id": "crd_7e2d1c0b9a8f7654321fedcba09876543",
        "cardholderId": "ch_9f8e7d6c5b4a3210fedcba9876543210",
        "name": "SARAH JOHNSON",
        "last4": "7156",
        "maskedNumber": "****7156",
        "expiryDate": "03/2029",
        "brand": "MASTERCARD",
        "status": "FROZEN",
        "isReloadable": true,
        "createdAt": "2026-01-05 09:15:00"
      }
    ],
    "pagination": {
      "currentPage": 1,
      "totalPages": 5,
      "totalItems": 48,
      "itemsPerPage": 20
    }
  },
  "meta": {
    "requestId": "req_a1b2c3d4e5f6",
    "timestamp": "2026-01-17T10:00:00+00:00"
  }
}

​
Overview

Retrieve a paginated list of all virtual cards issued under your application. You can filter by cardholder ID, card status, or search by card name.

​
Query Parameters

ParameterTypeDescription
cardholderIdstringFilter cards by cardholder ID
statusstringFilter by status: ACTIVE, FROZEN, SUSPENDED, TERMINATED
schemestringFilter by card scheme: VISA, MASTERCARD
searchstringSearch by card name, last 4 digits, or card ID
pageintegerPage number (default: 1)
limitintegerItems per page (default: 20, max: 100)

​
Example Usage

<?php
$queryParams = http_build_query([
    'status' => 'ACTIVE',
    'scheme' => 'MASTERCARD',
    'page' => 1,
    'limit' => 20
]);

$response = file_get_contents(
    'https://api.fyatu.com/api/v3/cards?' . $queryParams,
    false,
    stream_context_create([
        'http' => [
            'method' => 'GET',
            'header' => 'Authorization: Bearer ' . $accessToken
        ]
    ])
);

$result = json_decode($response, true);
foreach ($result['data']['cards'] as $card) {
    echo $card['name'] . ' - ****' . $card['last4'] . ' - ' . $card['status'] . "\n";
}

​
Response Fields

FieldTypeDescription
idstringUnique card identifier
cardholderIdstringThe cardholder this card belongs to
namestringName printed on the card
last4stringLast 4 digits of the card number
maskedNumberstringMasked card number (e.g., ****4829)
expiryDatestringCard expiration date (MM/YYYY format)
brandstringCard brand: MASTERCARD or VISA
statusstringCard status: ACTIVE, FROZEN, SUSPENDED, TERMINATED
isReloadablebooleanWhether the card can be funded
createdAtstringCard creation timestamp
Use the cardholderId filter to get all cards belonging to a specific cardholder. Use the search parameter to find cards by name or last 4 digits.

Authorizations

​
Authorization
string
header
required

JWT access token obtained from /auth/token

Query Parameters

​
cardholderId
string

Filter cards by cardholder ID

​
status
enum<string>

Filter by card status

Available options:
ACTIVE,
FROZEN,
SUSPENDED,
TERMINATED
​
search
string

Search by card name, last 4 digits, or card ID

​
scheme
enum<string>

Filter by card scheme

Available options:
VISA,
MASTERCARD
​
page
integer
default:1

Page number

​
limit
integer
default:20

Items per page (max 100)

Required range: x <= 100

Response

Cards retrieved successfully

​
success
boolean
Example:

true

​
status
integer
Example:

200

​
message
string
​
data
object
​
meta
object