Skip to main content
GET
/
runs
/
{id}
/
usage
Retrieve Run Usage
curl --request GET \
  --url https://api.example.com/runs/{id}/usage \
  --header 'Authorization: Bearer <token>'
{
  "stages": [
    {
      "stage": {
        "id": "propose-changes",
        "name": "Propose Changes"
      },
      "model": {
        "id": "claude-opus-4-6"
      },
      "usage": {
        "input_tokens": 28640,
        "output_tokens": 8750,
        "cost": 0.72
      },
      "runtime_secs": 154
    }
  ],
  "totals": {
    "runtime_secs": 389,
    "input_tokens": 71540,
    "output_tokens": 21080,
    "cost": 2.26
  },
  "by_model": [
    {
      "model": {
        "id": "claude-opus-4-6"
      },
      "stages": 2,
      "usage": {
        "input_tokens": 28640,
        "output_tokens": 8750,
        "cost": 0.72
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

JWT bearer token issued by fabro-web. See the Authentication guide for details.

Path Parameters

id
string
required

Unique run identifier (ULID).

Response

Usage data

Complete usage breakdown for a single run.

stages
object[]
required

Per-stage usage breakdown.

totals
object
required

Aggregate usage totals across all stages of a run.

by_model
object[]
required

Usage grouped by model.