Billing balance — Markdown source

> **AI Agents**: Index `/api/llms.txt` | Full `/api/llms-full-en.txt` | OpenAPI `/api/openapi.yaml`
> Base URL: `<BASE_URL>/v1`

# Billing balance

Return the available balance for the organization behind the current API key (sell-price USD).

```
GET <BASE_URL>/v1/billing/balance
```

## Authentication

Required: `Authorization: Bearer <API_KEY>` (same key as chat endpoints).

## Request

No query parameters, no body.

## Response (200)

```json
{
  "balance": {
    "value": "12.345678",
    "currency": "USD"
  }
}
```

| Field | Description |
|-------|-------------|
| `balance.value` | Decimal string — **available** balance (decreases with usage) |
| `balance.currency` | Typically `USD` |

Semantics:

- **Subscription (points)**: remaining points converted to USD at the platform default rate (1000 points = $1).
- **PAYG**: `available = ledger credit − same-day pending sell − arrears − frozen` (not the raw uncleared ledger total).

Probes may sample before/after a call and use the delta as a rough charge check; for exact per-request amounts use [Billing request](./billing-requests.md).

## Related

- [Usage (period)](./usage.md)
- [Billing request](./billing-requests.md)
- [Model pricing](./model-pricing.md)
- [Help: Billing & balance](/help/billing)