> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paywithatoa.com/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**

**accountId** `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](https://docs.paywithatoa.com/api-reference/account-initiation-services/fetch-all-accounts.md)
endpoint.

Refer:- [Accounts](https://docs.paywithatoa.com/accounts.md)

**Response**

**balance** `number`

The current balance amount in the bank account.

**currency** `string`

The currency code of the account balance (e.g., GBP, EUR, USD).

```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": "[]"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.