Get a generation or orchestration-run billing receipt
What one occurrence was billed, line by line: per-event line items with their measured components and unit prices, a per-meter-type split, and the totals. Pass generation_id for one generation, or orchestration_run_id for a receipt summed across every event the run metered. Exactly one of the two is required.
This is the itemisation behind a single number — where the meter says a window cost $12.40, a receipt says which components of which call made up one occurrence of it. On an orchestration-run receipt every line carries node_id, so grouping by it gives the per-node cost the total hides; a retried node contributes one line per attempt, which is the intended reading for spend.
Request
- Base URL: https://api.naturali.ai
- URL: https://api.naturali.ai/v1/projects/{project_id}/usage/receipt
- Auth: one of:
- HTTP bearer
- OAuth 2 (authorization code, authorization URL https://api.naturali.ai/authorize, token URL https://api.naturali.ai/token, scopes: mcp:access)
Query parameters
Generation public ID. Mutually exclusive with orchestration_run_id.
Orchestration run public ID. Returns the receipt summed across every generation the run metered. Mutually exclusive with generation_id.
Response
The receipt.
Example response
{
"currency": "USD",
"line_items": [
{
"event_id": "ue_V1StGXR8Z5jdHi6B",
"meter_type": "llm_tokens",
"provider": "bedrock",
"model": "nova-lite-v1",
"components": [
{
"component": "input_tokens",
"quantity": 1200,
"unit": "token"
}
]
}
]
}Changes
No recorded changes to this operation across all 1 revision of this API.