Skip to main content
GET
/
v1
/
card-issuer
/
customers
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/customers?status=active' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "data": {
    "customer_cards": [
      {
        "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
        "customer_id": "6627f3a2c5d4e100123abcde",
        "external_customer_id": "your_user_id_8821",
        "email_masked": "pr***@yourapp.com",
        "flow_status": "active",
        "kyc_status": "approved",
        "cards_count": 1,
        "cards": [
          {
            "card_id": "b2dc97ab-03f9-49eb-c72f-95be13815278",
            "last_four": "0892",
            "type": "virtual",
            "status": "Active",
            "is_frozen": false
          }
        ],
        "created_at": "2026-04-01T10:00:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 87,
      "total_pages": 5
    }
  }
}
Card issuer customers are separate from WaaS customers. This endpoint returns customers who have gone through card KYC onboarding and have a Gnosis Safe wallet for card spending. For wallet sub-accounts (deposits, withdrawals, crypto transfers), see WaaS Customers.
​
Authorization
string
required
Bearer token: Bearer YOUR_ACCESS_TOKEN
​
page
integer
Page number. Defaults to 1.
​
limit
integer
Results per page. Defaults to 20, max 100.
​
status
string
Filter by onboarding status. One of: otp_requested, otp_verified, kyc_initiated, kyc_completed, card_created, active.
curl -X GET 'https://crypto-api.yativo.com/api/v1/card-issuer/customers?status=active' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

{
  "success": true,
  "data": {
    "customer_cards": [
      {
        "yativo_card_id": "yativo_card_customer_8f9a..._1769031332068",
        "customer_id": "6627f3a2c5d4e100123abcde",
        "external_customer_id": "your_user_id_8821",
        "email_masked": "pr***@yourapp.com",
        "flow_status": "active",
        "kyc_status": "approved",
        "cards_count": 1,
        "cards": [
          {
            "card_id": "b2dc97ab-03f9-49eb-c72f-95be13815278",
            "last_four": "0892",
            "type": "virtual",
            "status": "Active",
            "is_frozen": false
          }
        ],
        "created_at": "2026-04-01T10:00:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 87,
      "total_pages": 5
    }
  }
}