---
title: "AllBalances queries the balance of all coins for a single account."
method: GET
path: "/cosmos/bank/v1beta1/balances/{address}"
tags: ["Query"]
---

# AllBalances queries the balance of all coins for a single account.

`GET /cosmos/bank/v1beta1/balances/{address}`

## Request

- Base URL: `https://backend.pay.kiichain.io`
- URL: `https://backend.pay.kiichain.io/cosmos/bank/v1beta1/balances/{address}`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Password
    - Token URL: `https://backend.pay.kiichain.io/users/v1/auth/login` scopes: `accounts.kyc.read`, `accounts.kyc.read:all`
- TypeScript: <https://skmtc.dev/kiiglobal/apis/kiichain-pay-backend/docs/cosmos/bank/v1beta1/balances/:address/get.ts> (a function with typed inputs; its response is checked against the schema)

When called from another module, this query might consume a high amount of
gas if the pagination field is incorrectly set.

## Response `200`

A successful response.

- object: QueryAllBalancesResponse is the response type for the Query/AllBalances RPC method.
  - `balances` object[]: balances is the balances of all the coins.
    - `denom` string
    - `amount` string
  - `pagination` object: pagination defines the pagination in the response.
    - `next_key` string, byte: next_key is the key to be passed to PageRequest.key to query the next page most efficiently. It will be empty if there are no more results.
    - `total` string, uint64

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/kiiglobal/apis/kiichain-pay-backend.md) - [All operations](https://skmtc.dev/kiiglobal/apis/kiichain-pay-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/kiiglobal/apis/kiichain-pay-backend/revisions/8951249f5b63?raw)