Skip to main content
GET
/
cards
/
{id}
Get a card
curl --request GET \
  --url https://api.fyatu.com/api/v3.20/cards/{id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "message": "Card retrieved",
  "data": {
    "id": "crd_01HXYZ5555ABCDEF1111",
    "cardholderId": "chl_01HXYZ1234ABCDEF5678",
    "productId": "prd_01HXYZ1111ABCDEF0001",
    "status": "ACTIVE",
    "cardType": "VIRTUAL",
    "cardBrand": "VISA",
    "maskedPan": "445123******4123",
    "last4": "4123",
    "expirationDate": "06/2030",
    "balance": 100,
    "currency": "USD",
    "cvv": "123",
    "features": {
      "has3DS": true,
      "hasApplePay": false,
      "hasGooglePay": false,
      "hasJIT": false,
      "hasSpendControl": true,
      "hasMccControl": false,
      "isReloadable": true,
      "isOneTimeUse": false
    },
    "spendingLimit": 1000,
    "spendingPeriod": "DAILY",
    "billingAddress": {
      "address": "1234 Main St",
      "city": "New York",
      "state": "NY",
      "zipCode": "10001",
      "country": "US"
    },
    "createdAt": "2026-05-26T10:00:00Z",
    "updatedAt": "2026-05-26T10:00:00Z"
  },
  "meta": {
    "requestId": "req_01HXY123456ABCDEF",
    "platform": "Fyatu CaaS",
    "timestamp": "2026-05-26T10:00:00Z"
  }
}

​
Overview

Returns the full details of a single card including live balance, full PAN, CVV, masked card number, expiry, and capability flags. Provider-internal fields are never returned.

​
Path Parameters

ParameterTypeDescription
idstringThe card ID (prefix crd_)

​
Example

curl https://api.fyatu.com/api/v3.20/cards/crd_01HXYZ5555ABCDEF1111 \
  -H "Authorization: Bearer $FYATU_API_KEY"

​
Success Response (200)

{
  "success": true,
  "status":  200,
  "message": "Card retrieved",
  "data": {
    "id":           "crd_01HXYZ5555ABCDEF1111",
    "cardholderId": "chl_01HXYZ1234ABCDEF5678",
    "productId":    "prd_01HXYZ1111ABCDEF0001",
    "status":       "ACTIVE",
    "cardType":     "VIRTUAL",
    "cardBrand":    "VISA",
    "maskedPan":    "445123******4123",
    "last4":        "4123",
    "pan":          "4451230000004123",
    "expirationDate": "06/2030",
    "balance":        100.00,
    "currency":       "USD",
    "cvv":            "123",
    "features": {
      "has3DS":          true,
      "hasApplePay":     false,
      "hasGooglePay":    false,
      "hasJIT":          false,
      "hasSpendControl": true,
      "hasMccControl":   false,
      "isReloadable":    true,
      "isOneTimeUse":    false
    },
    "spendingLimit":  1000.00,
    "spendingPeriod": "DAILY",
    "billingAddress": {
      "address": "1234 Main St",
      "city":    "New York",
      "state":   "NY",
      "zipCode": "10001",
      "country": "US"
    },
    "createdAt": "2026-05-26T10:00:00Z",
    "updatedAt": "2026-05-26T10:00:00Z"
  },
  "meta": {
    "requestId": "req_01HXY123456ABCDEF",
    "platform":  "Fyatu CaaS",
    "timestamp": "2026-05-26T10:00:00Z"
  }
}

​
Response Fields

FieldTypeDescription
idstringCard identifier (prefix crd_)
cardholderIdstringThe cardholder this card belongs to
productIdstringThe product the card was issued under
statusstringACTIVE, FROZEN, or TERMINATED
cardTypestringVIRTUAL or PHYSICAL
cardBrandstringVISA or MASTERCARD
maskedPanstringBIN-masked PAN — first 6 digits + 6 stars + last 4 (e.g. 445123******4123)
last4stringLast 4 digits of the PAN
panstringFull unmasked card number — only present when the card is provisioned at the provider
expirationDatestringCard expiry in MM/YYYY format (e.g. 06/2030)
balancenumberLive card balance in USD fetched from the card provider
currencystringCard currency (always USD)
cvvstringCard verification value
featuresobjectCard capability flags inherited from the product
features.has3DSboolean3D Secure enabled
features.hasApplePaybooleanApple Pay tokenisation supported
features.hasGooglePaybooleanGoogle Pay tokenisation supported
features.hasJITbooleanJust-In-Time funding enabled
features.hasSpendControlbooleanSpend limit control active
features.hasMccControlbooleanMCC (merchant category) control active
features.isReloadablebooleanCard can be topped up via POST /cards/{id}/fund
features.isOneTimeUsebooleanCard terminates automatically after its first settled transaction
spendingLimitnumberSpend cap per spendingPeriod in USD
spendingPeriodstringPeriod over which the spend cap applies — DAILY, WEEKLY, MONTHLY, etc.
billingAddressobjectBilling address registered with the card provider
billingAddress.addressstringStreet address
billingAddress.citystringCity
billingAddress.statestringState or region
billingAddress.zipCodestringPostal code
billingAddress.countrystringTwo-letter ISO 3166-1 country code
createdAtstringISO 8601 creation timestamp
updatedAtstringISO 8601 last-update timestamp

​
Conditional Fields

FieldPresent when
balanceCard has been provisioned at the provider
cvvCard has been provisioned at the provider
panCard has been provisioned at the provider
frozenAtstatus is FROZEN
terminatedAtstatus is TERMINATED

​
Error Codes

CodeHTTPCause
CARD_NOT_FOUND404Card does not exist or belongs to another business/environment
INSUFFICIENT_SCOPE403Key lacks cards:read scope
INTERNAL_ERROR500Server error

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required

Response

Card retrieved

​
success
boolean
Example:

true

​
status
integer
Example:

200

​
message
string
Example:

"Card retrieved"

​
data
object

Full card object returned by GET /cards/{id}. Includes live balance, full PAN, CVV, features, and billing address.

​
meta
object