API Reference

Runs

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Usage

Retrieve Usage For Run

client.runs.usage.retrieve(stringrunID, RequestOptionsoptions?): UsageRetrieveResponse { completion_tokens, completion_tokens_details, prompt_tokens, 2 more }

GET/v1/runs/{run_id}/usage

ModelsExpand Collapse

UsageRetrieveResponse { completion_tokens, completion_tokens_details, prompt_tokens, 2 more }

completion_tokens?: number

completion_tokens_details?: CompletionTokensDetails | null

reasoning_tokens?: number | null

prompt_tokens?: number

prompt_tokens_details?: PromptTokensDetails | null

cache_creation_tokens?: number | null

cache_read_tokens?: number | null

cached_tokens?: number | null

total_tokens?: number