X6.AI

Billing balance

Markdown version

Replace <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"
  }
}
FieldDescription
balance.valueDecimal string — available balance (decreases with usage)
balance.currencyTypically 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.

Related