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",
    "maskedNumber": "****4829",
    "cardNumber": "5412750000004829",
    "cvv": "847",
    "expiryMonth": "09",
    "expiryYear": "2028",
    "expiration": "09/28",
    "brand": "MASTERCARD",
    "status": "ACTIVE",
    "suspendedReason": null,
    "isReloadable": true,
    "balance": {
      "available": 245.5,
      "holding": 3
    },
    "spendingLimit": 5000,
    "spendingPeriod": "MONTHLY",
    "cardInvoiceDebt": 0,
    "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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.fyatu.com/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Returns the full details of a single card, including the complete card number and CVV. This is the only endpoint that returns sensitive card data.

Path Parameters

ParameterTypeDescription
cardIdstringThe card ID

Response Fields

FieldTypeDescription
idstringCard ID
cardholderIdstringCardholder this card belongs to
productIdstringCard product
programIdstringCard program
nameOnCardstringName on card
numberstringFull 16-digit card number
cvvstringCVV security code
last4stringLast 4 digits
maskedNumberstringMasked number
expiryDatestringExpiry (MM/YYYY)
expiryMonthstringExpiry month
expiryYearstringExpiry year
schemestringVISA or MASTERCARD
currencystringUSD or EUR
statusstringCard status
balancenumberCurrent balance
createdAtstringCreation timestamp
The number and cvv fields contain sensitive cardholder data (PCI DSS scope). Never log, store, or transmit these fields unencrypted. Display them securely to the cardholder and discard immediately.

Error Codes

CodeDescription
RESOURCE_NOT_FOUNDCard not found or belongs to another business

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