---
title: "Get Balances"
method: GET
path: "/api/b2b/users/balances"
---

# Get Balances

`GET /api/b2b/users/balances`

## Request

- Base URL: `https://api-v2.honeycoin.app`
- URL: `https://api-v2.honeycoin.app/api/b2b/users/balances`
- Auth: API key in header `Authorization`

Returns the authenticated account's balances as separate currency and country records. Use GET /api/sandbox/b2b/users/balances with a sandbox bearer token for sandbox data. Both environments return the same fields. Optional country and currency filters are combined; omit both to return all existing balance records. Filter values are trimmed and converted to uppercase. The bearer token determines the account; no publicKey or userId parameter is required. An empty result returns HTTP 200 with success:true and data:[]. Records with a global balance have country:null; omit the country filter to include them.

## Query parameters

- `country` string
- `currency` string

## Response `200`

Balance records matching the filters, or an empty array when none match.

- object
  - `success` true, required
  - `data` object[], required
    - `currency` string, required
    - `availableBalance` number, required: Available balance in the record's currency.
    - `country` string, nullable, required: Two-letter country code, or null for a global balance.

## Other responses

- `400`: Invalid query filters or a missing, invalid, or expired bearer token.
- `500`: Unable to read balances. The error code is API_GET_BALANCES_ERROR in production and SANDBOX_GET_BALANCES_ERROR in sandbox.

## Changes

- **2026-11-03** `fcb58b0ef441`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/changes/api/b2b/users/balances/get.md)

---

[API](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official.md) - [All operations](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/llms.txt) - [OpenAPI document](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/revisions/fcb58b0ef441?raw)