ManagementGet settlement for one invoked request
Get settlement for one invoked request
1 min readEdit this page
Returns only a request owned by the exact invoking credential. A request owned by another key is indistinguishable from an absent request (404). The response contains content-free usage, authoritative calculation/collection states, and the complete versioned immutable billing audit when present; it never includes prompt, response, or credential material.
Requires the inference:invoke scope.
x-api-key<token>
Anthropic-style API key header.
In: header
Path Parameters
request_id*string
Stable request id returned by the inference API.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/requests/string/settlement"{ "billing_audit": { "attempted_route_snapshots": [ { "account_label": "string", "byok_used": true, "canonical_model_id": "string", "pricing": { "base": { "input_cache_read": "string", "input_cache_write": "string", "input_no_cache": "string", "output_audio": "string", "output_image": "string", "output_reasoning": "string", "output_text": "string" }, "context_tiers": [ { "above_input_tokens": 0, "rates": { "input_cache_read": "string", "input_cache_write": "string", "input_no_cache": "string", "output_audio": "string", "output_image": "string", "output_reasoning": "string", "output_text": "string" } } ] }, "provider_id": "string", "provider_model_id": "string", "registry": { "content_sha256": "string", "loaded_at": "2019-08-24T14:15:22Z", "source_ref": "string" } } ], "audit_envelope_canonical_base64": "string", "audit_envelope_sha256": "string", "audit_hash_version": "string", "audit_schema_version": "string", "created_at": "2019-08-24T14:15:22Z", "decision": { "billable_usage": { "input_cache_read_tokens": 0, "input_cache_write_tokens": 0, "input_no_cache_tokens": 0, "output_reasoning_tokens": 0, "output_text_tokens": 0 }, "calculator_version": "string", "charge_breakdown": [ { "billable_tokens": 0, "bucket": "input_no_cache", "normalized_rate_micro_usd_per_million": 0, "scaled_numerator": 0 } ], "collection_required": true, "discount_snapshot": { "factor_bps": 0, "input_charge_micro_usd": 0, "output_charge_micro_usd": 0, "source": "policy_v2" }, "fallbacks": [ "cache_read_to_no_cache" ], "final_charge_micro_usd": 0, "normalized_pricing": { "input_cache_read": { "micro_usd_per_million": 0, "source_usd_per_million": "string" }, "input_cache_write": { "micro_usd_per_million": 0, "source_usd_per_million": "string" }, "input_no_cache": { "micro_usd_per_million": 0, "source_usd_per_million": "string" }, "output_audio": { "micro_usd_per_million": 0, "source_usd_per_million": "string" }, "output_image": { "micro_usd_per_million": 0, "source_usd_per_million": "string" }, "output_reasoning": { "micro_usd_per_million": 0, "source_usd_per_million": "string" }, "output_text": { "micro_usd_per_million": 0, "source_usd_per_million": "string" } }, "pre_discount_charge_micro_usd": 0, "reported_usage": { "cache_read_tokens": 0, "cache_write_tokens": 0, "completion_tokens": 0, "media_input_count": 0, "media_output_count": 0, "prompt_tokens": 0, "reasoning_tokens": 0, "web_search_count": 0 }, "request_succeeded": true, "status": "computed", "usage_capped": true, "usage_evidence": { "effective_usage": { "cache_read_tokens": 0, "cache_write_tokens": 0, "completion_tokens": 0, "media_input_count": 0, "media_output_count": 0, "prompt_tokens": 0, "reasoning_tokens": 0, "web_search_count": 0 }, "estimator": { "chars_per_token": 0, "version": "string" }, "raw_usage": { "cache_read_tokens": 0, "cache_write_tokens": 0, "completion_tokens": 0, "prompt_tokens": 0, "reasoning_tokens": 0, "web_search_count": 0 }, "raw_usage_frames": [ { "account_label": "string", "attempt_ordinal": 0, "frame_kind": "usage", "frame_ordinal": 0, "provider_id": "string", "provider_model_id": "string", "usage": { "cache_read_tokens": 0, "cache_write_tokens": 0, "completion_tokens": 0, "prompt_tokens": 0, "reasoning_tokens": 0, "web_search_count": 0 } } ], "source": "provider_reported" } }, "registry_snapshot": { "content_sha256": "string", "loaded_at": "2019-08-24T14:15:22Z", "source_ref": "string" }, "request_id": "string", "selected_account_label": "string", "selected_canonical_model_id": "string", "selected_pricing": { "base": { "input_cache_read": "string", "input_cache_write": "string", "input_no_cache": "string", "output_audio": "string", "output_image": "string", "output_reasoning": "string", "output_text": "string" }, "context_tiers": [ { "above_input_tokens": 0, "rates": { "input_cache_read": "string", "input_cache_write": "string", "input_no_cache": "string", "output_audio": "string", "output_image": "string", "output_reasoning": "string", "output_text": "string" } } ] }, "selected_provider_id": "string", "selected_provider_model_id": "string", "source_pricing": { "base": { "input_cache_read": "string", "input_cache_write": "string", "input_no_cache": "string", "output_audio": "string", "output_image": "string", "output_reasoning": "string", "output_text": "string" }, "context_tiers": [ { "above_input_tokens": 0, "rates": { "input_cache_read": "string", "input_cache_write": "string", "input_no_cache": "string", "output_audio": "string", "output_image": "string", "output_reasoning": "string", "output_text": "string" } } ] } }, "billing_collection_status": "pending", "billing_fallbacks": [ "cache_read_to_no_cache" ], "billing_status": "computed", "final_charge_micro_usd": 0, "model_id": "string", "provider_id": "string", "request_id": "string", "state": "pending", "usage": { "cache_read_tokens": 0, "cache_write_tokens": 0, "output_tokens": 0, "reasoning_tokens": 0, "uncached_input_tokens": 0 }}{ "error": "string", "error_description": "string"}{ "error": "string", "error_description": "string"}{ "error": "string", "error_description": "string"}How is this guide?