---
title: "List accounts"
method: GET
path: "/accounts"
tags: ["Accounts"]
---

# List accounts

`GET /accounts`

Retrieves a list of all accounts and their current balances.

## Query parameters

- `page` string
- `account_group` string
- `account_label` string
- `account_owner` string
- `asset` 'AAVE.ETH' | 'ADA' | 'ALGO' | 'AVAX' | 'BAT.ETH' | 'BCH' | 'BTC' | 'BUSD.ETH' | 'COMP.ETH' | 'DAI.ETH' | 'DOGE' | 'DOT' | 'EGLD' | 'EOS' | 'ETC' | 'ETH' | 'ETH.ARBITRUM' | 'GRT.ETH' | 'GYEN.ETH' | 'HBAR' | 'LINK.ETH' | 'LTC' | 'LUNA' | 'MATIC.ETH' | 'MATIC.POLYGON' | 'MKR.ETH' | 'MOB' | 'SAND.ETH' | 'SOL' | 'UNI.ETH' | 'USDC.ETH' | 'USDC.ALGO' | 'USDC.POLYGON' | 'USDC.SOL' | 'USDC.HBAR' | 'USDC.XLM' | 'USDC.AVAX' | 'USDT.ETH' | 'UST' | 'WBTC.ETH' | 'XEM' | 'XLM' | 'XRP' | 'XTZ' | 'ZUSD.ETH' — The list of assets available in the certification environment
- `account_type` string

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Response `200`

Successfully retrieved paginated list of accounts with current balances with optional filters: page, account_group, account_label, account_owner, asset, account_type.

- GetAccountsResponse — Response schema for retrieving zerohash account information.
  - `message` AccountsResponseEntity[]
    - `asset` string — The asset code for the specific account, e.g. `USD`
    - `account_owner` string — The code of the participant that owns the account
    - `account_type` 'available' | 'collateral' | 'payable' | 'receivable' | 'collateral_deficiency' | 'staked' — The type of the account (balance bucket).
    - `account_group` string — The group that the account is a part of
    - `account_label` string — The account label associated with the account
    - `balance` string — The balance in the account
    - `account_id` string, uuid — Unique ID of the specific account
    - `last_update` number — Timestamp when the account balance was updated (Unix milliseconds)
  - `page` number
  - `total_pages` number

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/versions/8b647d934363/schema)
