> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.paywithatoa.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch Account Balance

> Retrieve account balance via the Atoa Bank Feed API, request parameters, response schema and code samples in cURL, Python, JavaScript, PHP, Go and Java.

Use this to fetch the current balance and currency information of a linked bank account.

### Authorization

Bearer `<token>`

**Request Body Schema**

<ParamField path="accountId" type="string" required>
  ID of the user's bank account. This can be obtained from the redirect URL
  after account linking or by using the [Fetch All Accounts API
  Reference](/api-reference/AccountInitiationServices/fetch-all-accounts)
  endpoint.

  Refer:- [Accounts](/accounts)
</ParamField>

**Response**

<ResponseField name="balance" type="number">
  The current balance amount in the bank account.
</ResponseField>

<ResponseField name="currency" type="string">
  The currency code of the account balance (e.g., GBP, EUR, USD).
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "balance": 100.45,
    "currency": "GBP"
  }
  ```

  ```json 401 theme={null}
  {
    "name": "UNAUTHORIZED",
    "message": "Unauthorized",
    "status": 401,
    "errors": "[]"
  }
  ```

  ```json 404 theme={null}
  {
    "name": "NOT FOUND",
    "message": "Consent not found",
    "status": 404,
    "errors": "[]"
  }
  ```
</ResponseExample>