Skip to main content

Cost Response Headers

Every successful POST /v1/extract response includes X-Talonic-Cost-* headers showing credits consumed, EUR equivalent, remaining balance, and cell resolution breakdown.

Every successful POST /v1/extract response includes cost headers so AI agents can track spending without a separate API call:

Cost tracking is built into the extraction response to support autonomous agent workflows. Instead of polling a separate balance endpoint, agents read the cost headers inline and decide whether to trigger a top-up. The Cells-Resolved-Registry vs Cells-Resolved-AI breakdown shows how many fields were resolved from cached registry data (free) versus AI extraction (metered).

Response headers

X-Talonic-Cost-CreditsintegerCredits consumed for this extraction request.
X-Talonic-Cost-EURfloatEUR equivalent of credits consumed (at the configured rate).
X-Talonic-Balance-CreditsintegerRemaining credit balance after this request.
X-Talonic-Cells-Resolved-RegistryintegerNumber of fields resolved from the registry (no AI cost).
X-Talonic-Cells-Resolved-AIintegerNumber of fields resolved by AI extraction.

Example response headers

Agents can read these headers after every extraction to decide whether to call POST /v1/billing/topup to replenish credits.

Registry-resolved cells are free because the value was already known from a previous extraction. Over time, as your field registry grows, more cells resolve from the registry and fewer require paid AI extraction.

Related

POST /v1/extract
Auto Top-Up
Credits Balance