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

# Account Balance

> Retrieve the balance of every account attached to your organisation.

## Overview

Returns the balances held by your organisation across every currency you have been enabled for. Most accounts hold a single balance in their primary currency; organisations enabled for multiple regions receive one entry per currency.

<Tip>
  Use this endpoint to display available funds before initiating a vending or messaging request, and to reconcile wallet activity after transactions complete.
</Tip>

## Response Fields

<ResponseField name="AccountName" type="string">
  The registered name of your organisation.
</ResponseField>

<ResponseField name="GlobalBalance" type="array">
  One entry per account currency held by your organisation.

  <Expandable title="GlobalBalance item">
    <ResponseField name="Balance" type="number">
      Available balance for the account, in the account's currency.
    </ResponseField>

    <ResponseField name="Currency" type="string">
      ISO currency code (e.g. `NGN`, `USD`).
    </ResponseField>

    <ResponseField name="AccountNumber" type="string">
      Reference identifier for the account.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example Response

```json theme={null}
{
  "gatewayStatus": "00",
  "gatewayMessage": "Successfully Processed",
  "requestReference": "bpr_req_a1b2c3d4e5f6",
  "data": {
    "AccountName": "Acme Ltd",
    "GlobalBalance": [
      {
        "Balance": 7450.00,
        "Currency": "NGN",
        "AccountNumber": "ACC_0001"
      }
    ]
  }
}
```


## OpenAPI

````yaml GET /accountBalance
openapi: 3.0.3
info:
  title: Bleeprs API Specification 0.1
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.bleeprs.com/api
security:
  - bearerAuth: []
paths:
  /accountBalance:
    get:
      tags:
        - Insight
      summary: Account Balance
      description: Retrieve the balance of every account attached to your organisation.
      operationId: accountBalance
      responses:
        '200':
          description: Successfully retrieved account balances
          content:
            application/json:
              schema:
                type: object
                properties:
                  gatewayStatus:
                    type: string
                    example: '00'
                  gatewayMessage:
                    type: string
                    example: Successfully Processed
                  requestReference:
                    type: string
                    example: bpr_req_a1b2c3d4e5f6
                  data:
                    type: object
                    properties:
                      AccountName:
                        type: string
                        example: Acme Ltd
                      GlobalBalance:
                        type: array
                        items:
                          type: object
                          properties:
                            Balance:
                              type: number
                              example: 7450
                            Currency:
                              type: string
                              example: NGN
                            AccountNumber:
                              type: string
                              example: ACC_0001
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````