Balance

Get your current credit balance with EUR conversion, 30-day burn rate, projected runway in days, and your API tier via GET /v1/credits/balance.

The credit balance endpoint (GET /v1/credits/balance) returns how many credits your account has left, enriched with the EUR-equivalent balance, a 30-day burn rate, projected runway in days, and your current API tier. Credits are the universal billing unit for all Talonic operations, so one call answers "how much can I still process". It requires an API key with the read scope.

Call it to monitor consumption, alert on low balance, and plan capacity. Because the response already includes burn rate and runway, an agent can decide whether to trigger an auto top-up (POST /v1/billing/topup) or hand a human an upgrade link without any client-side math.

• balance_credits — Current credit balance as an integer.
• burn_rate_30d_credits — Credits consumed in the last 30 days for trend analysis.
• projected_runway_days — Estimated days remaining at the current burn rate.
• tier — Your current API tier (e.g. free, starter, growth), which determines rate limits and features.

Response

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

Errors