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

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

Response

success
boolean
required
Indicates if the request was successful
data
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