---
title: "List account balances"
method: GET
path: "/api/v1/balances"
tags: ["balances"]
---

# List account balances

`GET /api/v1/balances`

Returns a list of account and token balances on the network. The latest balance information is returned when there is no timestamp query parameter, otherwise, the information is retrieved from snapshots with 15-minute granularity. This information is limited to at most 50 token balances per account as outlined in HIP-367. As such, it's not recommended for general use and we instead recommend using either `/api/v1/accounts/{id}/tokens` or `/api/v1/tokens/{id}/balances` to obtain the current token balance information and `/api/v1/accounts/{id}` to return the current account balance.

## Query parameters

- `account.id` string
- `account.balance` string
- `account.publickey` string
- `limit` integer
- `order` 'asc' | 'desc'
- `timestamp` string[]

## Response `200`

OK

- BalancesResponse
  - `timestamp` string, nullable — A Unix timestamp in seconds.nanoseconds format
  - `balances` AccountBalance[]
    - `account` string, nullable, required — Network entity ID in the format of `shard.realm.num`
    - `balance` integer, required
    - `tokens` TokenBalance[], required
      - `token_id` string, nullable, required — Network entity ID in the format of `shard.realm.num`
      - `balance` integer, required
  - `links` Links
    - `next` string, nullable

## Other responses

- `400` — Invalid parameter

---

[API](https://skmtc.dev/hedera/apis/mirror-node-rest-api.md) · [All operations](https://skmtc.dev/hedera/apis/mirror-node-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hedera/mirror-node-rest-api/revisions/45f5ccac560c/schema)