Skip to main content
GET
/
v1
/
card-issuer
/
customers
/
{customerId}
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/customers/yativo_card_customer_8f9a...' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "external_id": "usr_8821",
    "email": "priya@yourapp.com",
    "flow_status": "active",
    "step": 6,
    "next_action": "Card is active — customer can spend",
    "kyc_status": "approved",
    "currency": "EUR",
    "safe_deployed": true,
    "ledger_balance": 145.50,
    "available_balance": 132.00,
    "pending_balance": 13.50,
    "balance_freshness": "realtime",
    "balance_updated_at": "2026-05-12T14:30:00.000Z",
    "cards_count": 2,
    "cards": [
      {
        "card_id": "afeb85fe-02f8-48da-b61e-84ad02704167",
        "last_four": "4242",
        "card_type": "virtual",
        "status": "active",
        "is_frozen": false,
        "is_lost": false,
        "is_stolen": false,
        "is_blocked": false,
        "is_void": false,
        "activated_at": "2026-04-25T12:00:00.000Z",
        "created_at": "2026-04-25T10:00:00.000Z"
      },
      {
        "card_id": "b3c19f2e-14a7-41bc-9e2d-93bf14815028",
        "last_four": "9876",
        "card_type": "virtual",
        "status": "frozen",
        "is_frozen": true,
        "is_lost": false,
        "is_stolen": false,
        "is_blocked": false,
        "is_void": false,
        "activated_at": "2026-05-01T08:00:00.000Z",
        "created_at": "2026-05-01T07:45:00.000Z"
      }
    ],
    "created_at": "2026-04-25T10:00:00.000Z"
  }
}

Documentation Index

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

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

​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
customerId
string
required
Customer identifier — accepts yativo_card_id, MongoDB _id, or external_customer_id.
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/customers/yativo_card_customer_8f9a...' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
    "external_id": "usr_8821",
    "email": "priya@yourapp.com",
    "flow_status": "active",
    "step": 6,
    "next_action": "Card is active — customer can spend",
    "kyc_status": "approved",
    "currency": "EUR",
    "safe_deployed": true,
    "ledger_balance": 145.50,
    "available_balance": 132.00,
    "pending_balance": 13.50,
    "balance_freshness": "realtime",
    "balance_updated_at": "2026-05-12T14:30:00.000Z",
    "cards_count": 2,
    "cards": [
      {
        "card_id": "afeb85fe-02f8-48da-b61e-84ad02704167",
        "last_four": "4242",
        "card_type": "virtual",
        "status": "active",
        "is_frozen": false,
        "is_lost": false,
        "is_stolen": false,
        "is_blocked": false,
        "is_void": false,
        "activated_at": "2026-04-25T12:00:00.000Z",
        "created_at": "2026-04-25T10:00:00.000Z"
      },
      {
        "card_id": "b3c19f2e-14a7-41bc-9e2d-93bf14815028",
        "last_four": "9876",
        "card_type": "virtual",
        "status": "frozen",
        "is_frozen": true,
        "is_lost": false,
        "is_stolen": false,
        "is_blocked": false,
        "is_void": false,
        "activated_at": "2026-05-01T08:00:00.000Z",
        "created_at": "2026-05-01T07:45:00.000Z"
      }
    ],
    "created_at": "2026-04-25T10:00:00.000Z"
  }
}

​
Customer fields

FieldDescription
yativo_card_idYativo’s canonical customer identifier
external_idYour own reference ID supplied at onboarding
emailCustomer email
flow_statusOnboarding stage — see onboarding stages
stepNumeric step (1–6)
next_actionWhat needs to happen next for this customer
kyc_statuspending, in_progress, pending_review, approved, rejected, or expired
currencyCard currency (USD, EUR, GBP) — null until a region is assigned during KYC
safe_deployedWhether the customer’s account wallet has been deployed

​
Balance fields

Balance is wallet-level — all cards issued to a customer share the same balance. Fields are null until the account wallet is deployed.
FieldDescription
ledger_balanceTotal token balance in the customer’s account wallet
available_balanceSpendable balance after deducting pending authorizations
pending_balanceAmount held for authorized but not yet settled transactions
balance_freshness"realtime" — sourced from live card notifications; "on_chain" — fetched directly from the blockchain (no pending info available)
balance_updated_atTimestamp of the last card notification that updated the balance (null when on-chain fallback was used)

​
Card fields

Each object in cards represents one card issued to this customer. Full card numbers and CVVs are never returned.
FieldDescription
card_idCard identifier
last_fourLast four digits of the card number
card_typevirtual or physical
statusactive, frozen, blocked, lost, or voided
is_frozenCard is temporarily frozen
is_lostCard reported lost
is_stolenCard reported stolen (treated as permanently voided)
is_blockedCard blocked by program or compliance
is_voidCard permanently disabled
activated_atWhen the card was first activated
created_atWhen the card was issued
To retrieve this customer’s transaction history use Customer Card Transactions. To fund the customer use Fund Customer.