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

# Get Balance

> Retrieve the current prepaid credit balance for your ARouter account.

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.arouter.ai/api/v1/balance \
    -H "Authorization: Bearer lr_live_xxxx"
  ```

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

  resp = requests.get(
      "https://api.arouter.ai/api/v1/balance",
      headers={"Authorization": "Bearer lr_live_xxxx"},
  )
  print(resp.json())
  ```

  ```typescript Node.js theme={null}
  const response = await fetch("https://api.arouter.ai/api/v1/balance", {
    headers: {
      Authorization: "Bearer lr_live_xxxx",
    },
  });

  console.log(await response.json());
  ```
</RequestExample>

## Response

```json theme={null}
{
  "balance": 42.50,
  "currency": "USD"
}
```

| Field      | Description                              |
| ---------- | ---------------------------------------- |
| `balance`  | Remaining prepaid credits in USD         |
| `currency` | Currency used for display and accounting |

## Notes

* This endpoint returns the account-level balance associated with the provided API key.
* If your account has pending top-ups, the visible balance may update shortly after settlement completes.
* For billing policy details, see [Billing & Credits](/en/guides/billing-and-credits).
