GET
/
end-users
List end users
curl --request GET \
  --url https://api.balansas.com/functions/v1/customer-api/end-users \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "id": "9e2b1c34-5d6e-4f70-8a91-2b3c4d5e6f70",
      "fr_end_user_id": "eu_5Lk9Pm",
      "end_user_type": "INDIVIDUAL",
      "first_name": "Maria",
      "middle_name": "Elena",
      "last_name": "Rossi",
      "company_name": "Helix Trading Ltd",
      "email": "[email protected]",
      "status": "pending_verification",
      "fr_owner_business_id": "busi_8Jh2KdLm5Qx",
      "registration_number": "12345678",
      "registration_date": "2019-06-15",
      "business_type": "LIMITED_COMPANY",
      "incorporation_country": "IE",
      "sector": "OTHER_PRODUCTS_SERVICES",
      "risk_tier": "low_risk",
      "verification_completed_at": "2026-05-21T08:00:00.000Z",
      "disclosure_accepted_at": "2026-05-23T10:05:00.000Z",
      "disclosure_version": "ppa-v1.2-2026-05-23",
      "created_at": "2026-05-28T11:02:09.456Z",
      "updated_at": "2026-05-28T11:02:09.456Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "limit": 25,
      "total": 100
    }
  }
}

Authorizations

x-api-key
string
header
required

Customer API key. Send as x-api-key: sk_... or Authorization: Bearer sk_.... Write operations also require an X-CSRF-Token header (64-char hex).

Response

Success

data
object[]
required
meta
object
required