Skip to main content
GET
/
v1
/
card-issuer
/
lookup-customer
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/lookup-customer?external_id=usr_8821' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a...abc_1769031332068",
    "external_id": "usr_8821",
    "email": "priya@yourapp.com",
    "flow_status": "card_created",
    "currency": "USD",
    "token": "USD",
    "safe_deployed": true,
    "cards_count": 1,
    "cards": [
      {
        "card_id": "afeb85fe-02f8-48da-b61e-84ad02704167",
        "last_four": "4242",
        "card_type": "virtual",
        "is_frozen": false,
        "is_lost": false,
        "is_blocked": false,
        "status": "active"
      }
    ],
    "created_at": "2026-04-25T10:00:00.000Z"
  }
}
​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
yativo_card_id
string
Yativo’s internal card customer ID (e.g. yativo_card_customer_8f9a..._1769031332068).
​
customer_id
string
Customer ObjectId, or falls back to yativo_card_id lookup if not a valid ObjectId.
​
card_id
string
Card ID returned from card creation.
​
external_id
string
Your reference ID set at onboarding.
​
email
string
Customer email address.
​
id
string
MongoDB _id of the customer document.
Pass exactly one identifier. yativo_card_id and external_id are the most reliable — prefer them over email if you have either.
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/lookup-customer?external_id=usr_8821' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "data": {
    "yativo_card_id": "yativo_card_customer_8f9a...abc_1769031332068",
    "external_id": "usr_8821",
    "email": "priya@yourapp.com",
    "flow_status": "card_created",
    "currency": "USD",
    "token": "USD",
    "safe_deployed": true,
    "cards_count": 1,
    "cards": [
      {
        "card_id": "afeb85fe-02f8-48da-b61e-84ad02704167",
        "last_four": "4242",
        "card_type": "virtual",
        "is_frozen": false,
        "is_lost": false,
        "is_blocked": false,
        "status": "active"
      }
    ],
    "created_at": "2026-04-25T10:00:00.000Z"
  }
}