v106

OpenAPI 3.1.0raw.githubusercontent.com2026-08-02160524464.6 KB
Run Outputs

Retrieve Run Billing

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

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

Path parameters

idstring required

Unique run identifier (ULID).

Response

Billing data

Example response

{
  "stages": [
    {
      "stage": {
        "id": "propose-changes",
        "name": "Propose Changes"
      },
      "model": {
        "provider": "anthropic"
      },
      "billing": {
        "input_tokens": 28640,
        "output_tokens": 8750,
        "total_tokens": 37390,
        "reasoning_tokens": 1200,
        "cache_read_tokens": 4800,
        "cache_write_tokens": 1500,
        "total_usd_micros": 720000
      },
      "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
    },
    "input_tokens": 71540,
    "output_tokens": 21080,
    "total_tokens": 92620,
    "reasoning_tokens": 3400,
    "cache_read_tokens": 22000,
    "cache_write_tokens": 4500,
    "total_usd_micros": 2260000
  },
  "by_model": [
    {
      "model": {
        "provider": "anthropic"
      },
      "stages": 2,
      "billing": {
        "input_tokens": 28640,
        "output_tokens": 8750,
        "total_tokens": 37390,
        "reasoning_tokens": 1200,
        "cache_read_tokens": 4800,
        "cache_write_tokens": 1500,
        "total_usd_micros": 720000
      }
    }
  ]
}