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

# Account Balances

> Retrieve your partner account fund balances across all currencies

Returns your current prepaid fund balances across all currencies loaded into your partner account. Check this before placing orders to ensure you have sufficient funds in the wallet currency you plan to use.

## Endpoint

GET /v2/accounts/balances

## Example Request

```bash theme={null}
curl -X GET https://partner.orbt.com/v2/accounts/balances \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-client-id: YOUR_CLIENT_ID" \
  -H "x-timestamp: 2026-08-13T10:00:00.000Z" \
  -H "x-body-hash: BODY_HASH" \
  -H "x-signature: SIGNATURE"
```

```javascript theme={null}
const response = await fetch('https://partner.orbt.com/v2/accounts/balances', {
  method: 'GET',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'x-client-id': 'YOUR_CLIENT_ID',
    'x-timestamp': timestamp,
    'x-body-hash': bodyHash,
    'x-signature': signature
  }
});
```

## Response — 200 OK

```json theme={null}
{
  "name": "Acme Corp",
  "paymentType": "Funds On Account",
  "fundsList": [
    { "funds": 611917.20, "currency": "USD" },
    { "funds": 251.50, "currency": "SAR" },
    { "funds": 14951.25, "currency": "AED" }
  ]
}
```

## Response Fields

| Field                  | Type   | Description                                                    |
| ---------------------- | ------ | -------------------------------------------------------------- |
| `name`                 | string | Your partner account name                                      |
| `paymentType`          | string | Payment model — always `Funds On Account` for prepaid partners |
| `fundsList`            | array  | List of balances per currency                                  |
| `fundsList[].funds`    | number | Available balance                                              |
| `fundsList[].currency` | string | ISO 4217 currency code                                         |

## Error Responses

| Status | Code                   | Description                               |
| ------ | ---------------------- | ----------------------------------------- |
| `401`  | `AUTHENTICATION_ERROR` | Missing or invalid authentication headers |
