---
description: "This endpoint retrieves a paginated list of balances for the Business User's account."
title: "Balances"
---

# Balances

> This endpoint retrieves a paginated list of balances for the Business User's account.

```http
GET /balances
```

- `https://api.sandbox.noah.com/v1/balances` — V1 Sandbox Server
- `https://api.noah.com/v1/balances` — V1 Production Server

## Authentication

- `X-Api-Key`: Your Noah API key. Required on all requests. See [API Keys](/api-concepts/authentication/api).
- `Api-Signature`: Digitally signed JWT used to verify request authenticity. Optional in sandbox when your API key has no associated signing public key; required in production for all requests. If sent, the signature is always validated. See [Request Signing](/api-concepts/authentication/signing).

## Query parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `PageSize` | integer | No | (default `20`) |
| `PageToken` | string | No |  |

## Responses

### 200 — List of balances

#### `application/json`

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `Items` | object[] | Yes |  |
| `Items[].AccountType` | string | Yes | Type of account: * Current |
| `Items[].CryptoCurrency` | string | Yes | Cryptocurrency: \| Environment \| BTC \| ETH \| USDC \| \|------------\|-----\|-------\|------\| \| Sandbox \| BTC_TEST \| ETH_TEST_SEPOLIA \| USDC_TEST \| \| Production \| BTC \| ETH \| USDC \| |
| `Items[].Available` | string | Yes | Amount available to spend. (length 1-38; pattern `^[+]?([.]\d+\|\d+[.]?\d*)$`) |
| `Items[].Total` | string | Yes | Amount including outflows that have not yet settled. (length 1-38; pattern `^[+]?([.]\d+\|\d+[.]?\d*)$`) |
| `PageToken` | string | No |  |

### 400 — Bad request

### 401 — Client is not authorized to perform this action

### 500 — Internal server error

Error responses share one `Error` envelope across the whole API. See https://docs.noah.com/api-concepts/errors.md for its fields, the `Type` values, and the field-level validation details in `RequestExtension` and `DenyExtension`.

## See also

- Rendered reference: https://docs.noah.com/api-reference/balances
- OpenAPI document: https://docs.noah.com/files/oas-schema.generated.json