# The User's Balances on the Local Rails

> Coming soon, upon request — this feature is turned on for your tenant by the Aurea team. [Contact us](https://www.aureahub.com/contact)

What the user holds on the local rails, per asset.

## Overview

- `spendable`: what the user may withdraw, sell or confirm in a desk order now.
- `onHold`: money reserved by withdrawals and desk orders in progress, and pay-ins still inside your tenant's reversal window.
- Amounts are decimal text in the asset's major unit.

Called with the user's access token, in one environment (`isTestnet`). See [Bank Ramp: Local Rails](https://docs.aureahub.com/docs/guide-bank-local.md).

## Endpoint

### `GET /v1/ramp/bank/customer/balances`

Authentication: bearer token required.

The user's balances on the local rails, per asset.

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `isTestnet` | boolean | no | `true` for the sandbox; `false` or omitted for production |

**Responses**

`200` Balances

```json
{
  "environment": "production",
  "balances": [
    {
      "asset": "KES",
      "spendable": "14775.36",
      "onHold": "0"
    },
    {
      "asset": "USDT",
      "spendable": "120.5",
      "onHold": "30"
    }
  ]
}
```

`403` No tenant

```json
{
  "statusCode": 403,
  "error": "ForbiddenError",
  "message": "This request needs a tenant: an admin token without one has no bank ramp customer.",
  "details": {
    "code": "TENANT_REQUIRED"
  }
}
```

---

Web version: https://docs.aureahub.com/#local-balances