Sign in
Run Outputs

Retrieve Run Usage

Returns token counts and costs broken down by stage and model for a specific run.

get/api/v1/runs/{id}/usage

Path parameters

idstring required

Unique run identifier (ULID).

Response

Usage data

Example response

{
  "stages": [
    {
      "stage": {
        "id": "propose-changes",
        "name": "Propose Changes"
      },
      "model": {
        "provider": "anthropic"
      },
      "timing": {
        "wall_time_ms": 1500,
        "inference_time_ms": 900,
        "tool_time_ms": 200,
        "active_time_ms": 1100
      },
      "started_at": "2026-04-29T12:34:56Z"
    }
  ],
  "totals": {
    "timing": {
      "wall_time_ms": 420000,
      "inference_time_ms": 120000,
      "tool_time_ms": 60000,
      "active_time_ms": 180000
    }
  },
  "by_model": [
    {
      "model": {
        "provider": "anthropic"
      },
      "stages": 2
    }
  ]
}

Changes

Changed in 2 of the 172 revisions of this API.2