API Reference

Runs

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Usage

Retrieve Usage For Run

GET/v1/runs/{run_id}/usage

ModelsExpand Collapse

UsageRetrieveResponse object { completion_tokens, completion_tokens_details, prompt_tokens, 2 more }

completion_tokens: optional number

completion_tokens_details: optional object { reasoning_tokens }

reasoning_tokens: optional number

prompt_tokens: optional number

prompt_tokens_details: optional object { cache_creation_tokens, cache_read_tokens, cached_tokens }

cache_creation_tokens: optional number

cache_read_tokens: optional number

cached_tokens: optional number

total_tokens: optional number