Skip to main content

Balance

Get the current credit balance for the authenticated customer including currency and timestamp. Requires read scope.

Credit endpoints expose the current balance, transaction history, aggregate usage summaries, daily usage, and a per-request usage log with model and token counts. Track credit balance and usage breakdowns by operation type and time period.

GET/v1/credits/balance

Response

Response fields

balance_creditsintegerCurrent credit balance.
balance_eurnumberCredit balance converted to EUR at the configured rate.
burn_rate_30d_creditsintegerCredits consumed over the last 30 days.
projected_runway_daysintegerEstimated days of runway at the current burn rate. -1 if burn rate is zero.
tierstringCurrent API tier (e.g. free, starter, growth).
tier_resets_atstringISO 8601 timestamp when the tier resets (1st of next month UTC).

Response

{
  "balance_credits": 4250,
  "balance_eur": 4.25,
  "burn_rate_30d_credits": 1800,
  "projected_runway_days": 70,
  "tier": "starter",
  "tier_resets_at": "2026-05-01T00:00:00.000Z"
}

Errors

Error responses

401unauthorizedMissing or invalid API key.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

Related

History
Usage Summary