Get Account Details

Returns full configuration for one account, including fees and binList (use these when issuing cards).

Endpoint

GET /api/v2/accounts/{account_uuid}

Request

curl -s "https://api.4pay.cc/api/v2/accounts/ACCOUNT_UUID" \
  -H "X-API-Token: YOUR_API_TOKEN"

Response (illustrative)

{
  "id": "019d2236-2511-728e-96de-27fca03a9c48",
  "name": "Main Account",
  "balance": "1000.000000000",
  "holdedBalance": "50.000000000",
  "availableBalance": "950.000000000",
  "currency": "USD",
  "status": "active",
  "allowedCardTypes": ["virtual", "physical"],
  "cards": 5,
  "isTransferAllowed": true,
  "isUsedCardBalance": true,
  "fees": {
    "cardTransactions": { "type": "percent", "percent": "2.5" },
    "cardIssuing": { "type": "amount", "amount": "5.00", "currency": "USD" }
  },
  "binList": [
    {
      "cardProviderBinId": "ff246e21-3bda-4e47-83fb-05203939fe5b",
      "bin": "411111",
      "cardNetwork": "visa",
      "issuerCountry": "US",
      "cardTokenizations": ["apple_pay", "google_pay"],
      "categoryIds": ["7c9e6679-7425-40de-944b-e07fc1f90ae7"]
    }
  ],
  "createdAt": "2026-03-24T23:37:47+00:00",
  "updatedAt": "2026-03-24T23:37:49+00:00"
}

Errors

Code	Meaning
404	Unknown account or not your merchant
502	Upstream provider failure