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

# Get balance

> Check your account's available balance.

Retrieve your account balance, including funds reserved against in-flight jobs.

```text theme={null}
GET /balance
```

## Headers

<ParamField header="Authorization" type="string" required>
  `Bearer <YOUR_API_KEY>`. See [Authentication](/authentication).
</ParamField>

## Response

<ResponseField name="balance" type="string (decimal)">
  Total deposited balance.
</ResponseField>

<ResponseField name="reserved" type="string (decimal)">
  Held against jobs that haven't completed yet.
</ResponseField>

<ResponseField name="available" type="string (decimal)">
  `balance − reserved` — what you can spend now.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -s https://bananahub.io/api/v1/balance \
    -H "Authorization: Bearer $API_KEY"
  ```

  ```python Python theme={null}
  import requests

  balance = requests.get(
      "https://bananahub.io/api/v1/balance",
      headers={"Authorization": f"Bearer {API_KEY}"},
  ).json()
  print(balance["available"])
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "balance": "100.00",
    "reserved": "5.50",
    "available": "94.50"
  }
  ```
</ResponseExample>

<Tip>
  A generation returns `402` when `available` doesn't cover the job's reserved price. See [Errors](/concepts/errors).
</Tip>
