Skip to main content

List Cardholders

For one account​

GET /api/v2/accounts/{account_uuid}/cardholders?limit=100&offset=0

All cardholders (merchant)​

GET /api/v2/cardholders?limit=100&offset=0

Request​

curl -s "https://api.4pay.cc/api/v2/cardholders?limit=50&offset=0" \
  -H "X-API-Token: YOUR_API_TOKEN"

Response​

{
  "items": [
    {
      "cardOwnerId": "owner-12345",
      "firstName": "Ivan",
      "lastName": "Petrov",
      "email": "ivan@example.com",
      "phone": "79001234567",
      "address": null
    }
  ],
  "total": 42
}

Get Cardholder

GET /api/v2/cardholders/{card_owner_id}

card_owner_id is the string identifier you passed when creating the cardholder.

curl -s "https://api.4pay.cc/api/v2/cardholders/owner-12345" \
  -H "X-API-Token: YOUR_API_TOKEN"

Get Cards for Cardholder

Returns all cards issued to a specific cardholder across all accounts.

GET /api/v2/cardholders/{card_owner_id}/cards
curl -s "https://api.4pay.cc/api/v2/cardholders/owner-12345/cards" \
  -H "X-API-Token: YOUR_API_TOKEN"

Response​

{
  "items": [
    {
      "cardId": "019cd7a9-8482-708a-addc-63885bd9403c",
      "accountUuid": "019d2236-2511-728e-96de-27fca03a9c48",
      "name": "Company Expenses Card",
      "status": "active",
      "maskedNumber": "111111******2707",
      "availableBalance": "100.00",
      "currency": "USD"
    }
  ]
}