curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/lookup-customer?external_id=usr_8821' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/lookup-customer?yativo_card_id=yativo_card_customer_8f9a..._1769031332068' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/lookup-customer?email=priya%40yourapp.com' \
-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"
}
}
{
"success": false,
"error": "MISSING_IDENTIFIER",
"message": "Provide one of: id, yativo_card_id, customer_id, card_id, external_id, email"
}
{
"success": false,
"error": "CUSTOMER_NOT_FOUND"
}
Card Issuer Program
Look Up Customer
Find a card customer record by any identifier
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'
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/lookup-customer?yativo_card_id=yativo_card_customer_8f9a..._1769031332068' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/lookup-customer?email=priya%40yourapp.com' \
-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"
}
}
{
"success": false,
"error": "MISSING_IDENTIFIER",
"message": "Provide one of: id, yativo_card_id, customer_id, card_id, external_id, email"
}
{
"success": false,
"error": "CUSTOMER_NOT_FOUND"
}
string
required
Bearer token:
Bearer YOUR_ACCESS_TOKENstring
Yativo’s internal card customer ID (e.g.
yativo_card_customer_8f9a..._1769031332068).string
Customer ObjectId, or falls back to
yativo_card_id lookup if not a valid ObjectId.string
Card ID returned from card creation.
string
Your reference ID set at onboarding.
string
Customer email address.
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'
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/lookup-customer?yativo_card_id=yativo_card_customer_8f9a..._1769031332068' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/lookup-customer?email=priya%40yourapp.com' \
-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"
}
}
{
"success": false,
"error": "MISSING_IDENTIFIER",
"message": "Provide one of: id, yativo_card_id, customer_id, card_id, external_id, email"
}
{
"success": false,
"error": "CUSTOMER_NOT_FOUND"
}
⌘I