# Get Virtual Account Balances Total

Retrieves the total balance across all virtual accounts. This endpoint:
            
- Returns a single object { currency, amount } (one record)
- Supports both JSON and CSV response formats based on the Accept header
- Pagination: This endpoint does not accept pagination parameters
            
### Sample Response (JSON)
json
{
  "currency": "USD",
  "amount": "6755.67"
}

            
### Content Negotiation
Clients must use the HTTP Accept header to indicate the desired response format:
- Set Accept: application/json for JSON responses (default)
- Set Accept: text/csv for CSV responses
If the Accept header is omitted, application/json is assumed.
            
### Base URL
All API requests use the versioned base URL:
            
    https://api.bcb.bm/v1/virtual-accounts/balances/total
            
### Sample Request in JavaScript
javascript
async function getVirtualAccountBalancesTotal() {
  const response = await fetch('https://api.bcb.bm/v1/virtual-accounts/balances/total', {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
      'Accept': 'application/json'
    }
  });
            
  if (!response.ok) {
    const errorData = await response.json();
    throw new Error(Failed to retrieve total balance: ${JSON.stringify(errorData)});
  }
            
  const result = await response.json();
  console.log(result.data?.amount, result.data?.currency);
  return result;
}


Required Permission: get-virtual-account-transactions

This endpoint requires the permission claim get-virtual-account-transactions to be present in the JWT token. These permissions are embedded in the token during the authentication process and cannot be modified afterward. The token must be obtained with the appropriate permissions to access this endpoint.

Endpoint: GET /v1/virtual-accounts/balances/total
Version: v1
Security: Authorization, Feature Permissions, Authorization

## Response 200 fields (application/json):

  - `currency` (string, required)
    Currency ISO code

  - `amount` (string, required)
    Amount

## Response 400 fields (application/json):

  - `error` (string, required)

  - `message` (string, required)

## Response 401 fields (application/json):

  - `error` (string, required)

  - `message` (string, required)

## Response 403 fields (application/json):

  - `error` (string, required)

  - `message` (string, required)

## Response 429 fields (application/json):

  - `error` (string, required)

  - `message` (string, required)

## Response 500 fields (application/json):

  - `error` (string, required)

  - `message` (string, required)