Sign in
Account Holders

List account holders

Returns a paginated list of account holders scoped to the authenticated tenant.

Supports Flop pagination and filtering:

  • page - Page number (1-indexed, default: 1)
  • page_size - Items per page (default: 20, max: 100)
  • order_by - Field to sort by
  • order_directions - Sort direction (asc or desc)
  • filters - Flop filters (account_holder_type, status, kyc_status, risk_level)
get/api/account-holders

Request

  • Base URL: http://localhost:4100
  • URL: http://localhost:4100/api/account-holders
  • Auth: none required

Query parameters

pageinteger

Page number (1-indexed)

page_sizeinteger

Items per page (max: 100)

order_bystring

Field to sort by

order_directionsstring

Sort direction (asc or desc)

Response

Account holder list

Example response

{
  "data": [
    {
      "account_holder_number": "",
      "account_holder_type": "individual",
      "beneficial_owners": [
        null
      ],
      "enabled_currencies": [
        ""
      ],
      "enabled_regimes": [
        ""
      ],
      "external_id": "",
      "id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
      "inserted_at": "2020-04-20T16:20:00Z",
      "kyc_status": "not_started",
      "last_reviewed_at": "2020-04-20T16:20:00Z",
      "legal_entity": null,
      "onboarded_at": "2020-04-20T16:20:00Z",
      "risk_level": "low",
      "status": "pending",
      "tenant_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
      "updated_at": "2020-04-20T16:20:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "page_size": 50,
    "total_count": 125,
    "total_pages": 3
  }
}

Changes