Skip to main content
GET
List Usage Records

List Usage Records

Returns token usage records with optional filtering by work order, run, model, and date range.

Request

string
Filter by work order ID
string
Filter by run ID
string
Filter by model name (e.g., claude-sonnet-4-20250514)
string
Start date filter (ISO 8601)
string
End date filter (ISO 8601)
integer
default:"100"
Maximum number of records to return (1-1000)
integer
default:"0"
Number of records to skip for pagination

Response

boolean
required
Indicates if the request was successful
array
required
Array of usage records

Example Response

Use Cases

  • Track token usage per work order
  • Analyze model costs over time
  • Audit execution history
  • Generate billing reports