Skip to main content
GET
/
cards
/
{cardId}
Get Card Details
curl --request GET \
  --url https://api.fyatu.com/api/v3/cards/{cardId} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "message": "Card retrieved successfully",
  "data": {
    "id": "crd_8f3a2b1c4d5e6f7890abcdef12345678",
    "cardholderId": "ch_1a2b3c4d5e6f7890abcdef1234567890",
    "name": "JAMES WILSON",
    "last4": "4829",
    "cardNumber": "5412750000004829",
    "cvv": "847",
    "expiryMonth": "09",
    "expiryYear": "2028",
    "brand": "MASTERCARD",
    "status": "ACTIVE",
    "suspendedReason": null,
    "isReloadable": true,
    "balance": {
      "available": 245.5,
      "holding": 3
    },
    "spendingLimit": 5000,
    "declineCount": 0,
    "billingAddress": {
      "line1": "742 Evergreen Terrace",
      "city": "Springfield",
      "state": "Illinois",
      "country": "US",
      "zipCode": "62701"
    },
    "createdAt": "2026-01-10 14:30:00",
    "suspendedAt": null,
    "terminatedAt": null
  },
  "meta": {
    "requestId": "req_a1b2c3d4e5f6",
    "timestamp": "2026-01-17T10:00:00+00:00"
  }
}

Overview

Retrieve full card details including the card number, CVV, and expiration date. This endpoint returns sensitive PCI data that should be handled securely.
Security Notice: This endpoint returns full card details (card number, CVV). Never expose this data in client-side code, logs, or analytics.

Path Parameters

ParameterTypeDescription
cardIdstringThe unique card identifier

Example Usage

<?php
$cardId = 'crd_8f3a2b1c4d5e6f7890abcdef12345678';

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

$result = json_decode($response, true);
$card = $result['data'];

echo "Card Number: " . $card['cardNumber'] . "\n";
echo "CVV: " . $card['cvv'] . "\n";
echo "Expiry: " . $card['expiryMonth'] . '/' . $card['expiryYear'] . "\n";
echo "Balance: $" . $card['balance']['available'] . "\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
cardNumberstringFull 16-digit card number (PCI sensitive)
cvvstring3-digit security code (PCI sensitive)
expiryMonthstringCard expiration month (MM format)
expiryYearstringCard expiration year (YYYY format)
brandstringCard brand: MASTERCARD or VISA
statusstringCard status: ACTIVE, FROZEN, SUSPENDED, TERMINATED
suspendedReasonstringReason for suspension (if applicable)
isReloadablebooleanWhether the card can be funded
balance.availablenumberAvailable balance in USD
balance.holdingnumberHeld/pending balance in USD
spendingLimitnumberMonthly spending limit in USD
declineCountintegerNumber of declined transactions due to insufficient funds
billingAddressobjectCard billing address
createdAtstringCard creation timestamp
suspendedAtstringWhen the card was suspended (if applicable)
terminatedAtstringWhen the card was terminated (if applicable)
Decline Count: Cards are automatically suspended after 15 consecutive insufficient funds declines. Monitor declineCount to warn cardholders before suspension.

Authorizations

Authorization
string
header
required

JWT access token obtained from /auth/token

Path Parameters

cardId
string
required

Card ID

Response

Card details retrieved

success
boolean
Example:

true

status
integer
Example:

200

message
string
data
object
meta
object