---
title: "List Account Balances by Reference"
method: GET
path: "/partners/accounts/{account_ref}/balances"
tags: ["Partners"]
---

# List Account Balances by Reference

`GET /partners/accounts/{account_ref}/balances`

## Request

- Base URL: `//mapi.boomfi.xyz` (relative, and the document’s source URL is not known)
- URL: `//mapi.boomfi.xyz/partners/accounts/{account_ref}/balances`
- Auth: one of:
  - API key in header `X-API-KEY`
  - API key in header `X-API-Signature`
  - API key in header `X-API-Nonce`
- TypeScript: <https://skmtc.dev/boomfi/apis/boomfi-merchants-api/docs/partners/accounts/:account_ref/balances/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the balances associated with a specific account. Obtain the list of all balances for a given account reference. Balances include details on available funds, locked funds, and asset types. This is essential for monitoring account liquidity and financial activity.

## Path parameters

- `account_ref` string, required

## Response `200`

OK

- PartnersBalanceResponse[]
  - `account_id` integer
  - `account_reference` string
  - `amount` string
  - `amount_usd` string
  - `chain` AccountsChainResponse
    - `category` string: The category or classification of the chain.
    - `code` string: The code or abbreviation associated with the chain.
    - `is_testnet` boolean: Indicates whether the chain is a testnet (true) or not (false).
    - `name` string: The name or title associated with the chain.
    - `native_currency_symbol` string: The symbol representing the native currency of the chain.
  - `currency` string
  - `token_address` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/boomfi/apis/boomfi-merchants-api.md) - [All operations](https://skmtc.dev/boomfi/apis/boomfi-merchants-api/llms.txt) - [OpenAPI document](https://skmtc.dev/boomfi/apis/boomfi-merchants-api/revisions/ace3c3df05fe?raw)