> ## Documentation Index
> Fetch the complete documentation index at: https://developer.quickei.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Wallet Balance

> Get your merchant wallet balances

Retrieve the current balances of all active wallets on your merchant account.

## Example Request

```bash theme={null}
curl -X GET https://quickei.io/api/partner/sandbox/v1/balance \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"
```

## Success Response `200`

```json theme={null}
{
  "message": {
    "success": ["Wallet balances."]
  },
  "data": {
    "balances": [
      {
        "currency_code": "EUR",
        "currency_symbol": "\u20ac",
        "balance": 12450.75
      },
      {
        "currency_code": "USD",
        "currency_symbol": "$",
        "balance": 5320.00
      },
      {
        "currency_code": "XAF",
        "currency_symbol": "FCFA",
        "balance": 1500000.00
      }
    ]
  }
}
```

<ResponseField name="balances" type="array">
  List of all active wallets on the merchant account.
</ResponseField>

<ResponseField name="balances[].currency_code" type="string">
  ISO 4217 currency code.
</ResponseField>

<ResponseField name="balances[].currency_symbol" type="string">
  Currency symbol for display (e.g. `$`, `FCFA`).
</ResponseField>

<ResponseField name="balances[].balance" type="number">
  Current wallet balance.
</ResponseField>

<Info>
  Only wallets with an active currency are returned. If a currency is deactivated by the platform, the wallet will not appear in the response.
</Info>

## Error Responses

| Status | Message                  | Cause                       |
| ------ | ------------------------ | --------------------------- |
| `401`  | Invalid API credentials. | Bad or missing Bearer token |