# Get the wallet balance

> The balance of the wallet for the key's mode.

Source: https://useroutegate.com/docs/api/public/getWalletBalance

`GET /api/v1/wallet/balance`

`available_kobo` is `balance_kobo` less what is held for vends still running, and is what the next vend can spend. See [wallet and funding](/docs/concepts/wallet).

Authenticate with a bearer API key: `rg_test_` in test mode, `rg_live_` in live.

## Request

```bash
curl -X GET https://api.useroutegate.com/api/v1/wallet/balance \
  -H "Authorization: Bearer $ROUTEGATE_API_KEY"
```

## Response

`200`

```json
{
  "success": true,
  "code": "OK",
  "message": "OK",
  "data": {
    "id": "01a0d8c1-2f4e-7b90-8a31-9c5d7e2f4b18",
    "mode": "test",
    "currency": "NGN",
    "balance_kobo": 500000,
    "held_kobo": 10000,
    "available_kobo": 490000,
    "low_balance_threshold_kobo": 0,
    "updated_at": "2026-09-25T14:02:11Z"
  }
}
```

## Error

`401` `AUTH_REQUIRED`: The key is missing, unknown, revoked or expired. Every code is in [errors](/docs/concepts/errors).

```json
{
  "success": false,
  "data": null,
  "message": "Invalid API key",
  "code": "AUTH_REQUIRED"
}
```

## Give this to your coding agent

Read `https://useroutegate.com/docs/api/public/getWalletBalance.md` and implement this call. Amounts are integers in kobo.