Skip to main content

Credits & Billing

Every synchronous /v1/extract response includes cost headers so your agent or application always knows the spend. Query the balance endpoint for runway projections.

Cost headers

Returned on every successful extraction response:

X-Talonic-Cost-Credits: 70
X-Talonic-Cost-EUR: 0.07
X-Talonic-Balance-Credits: 64930

Check balance

GET/v1/credits/balance
curl https://api.talonic.com/v1/credits/balance \
  -H "Authorization: Bearer $TALONIC_API_KEY"

# Response:
# {
#   "balance_credits": 64930,
#   "burn_rate_30d_credits": 12400,
#   "projected_runway_days": 157
# }

Auto top-up

Auto top-up is human-gated. A human enables it via PATCH /v1/billing/settings, then agents can call POST /v1/billing/topup. The agent cannot enable top-up itself — returns 403 if not enabled by a human.

Related

Extract
Synchronous extraction with cost headers.
Pricing
Credit costs per operation and tier details.
Credits Dashboard
Usage tracking in the platform UI.