Billing balance
Markdown versionReplace <BASE_URL> with https://api.x6.ai. See Endpoints.
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)
{
"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.