Get Builder usage

Builder spend, in tokens weighted at each model’s rates (`tokensBurnt`): all-time totals and a breakdown by model, plus the last thirty days by day. An engineer sees the company’s, with `employees` and each day’s `byEmployee` splitting it per person (the Self Healer’s under `bot`); everyone else sees only what they ran, and no `employees`.

Required scope

The access token must carry this scope. A token missing it gets 403 Forbidden. Grant them to an API client under Dev Tools → API, to an assistant or CLI sign-in when you approve or edit it under Dev Tools, and to a teammate under Employee → Permissions.

builder:read

GETExample request

curl

curl -X GET "https://www.pxb.app/api/public/v1/builder/usage" \
  -H "Authorization: Bearer your_access_token"

200Example response

json

{
  "message": "Builder usage retrieved successfully!",
  "content": {
    "usage": {
      "totals": {
        "tokensBurnt": 48120000,
        "inputTokens": 40200000,
        "outputTokens": 1900000,
        "cacheCreationInputTokens": 2100000,
        "cacheReadInputTokens": 61000000,
        "events": 1412,
        "sessions": 37
      },
      "byModel": [
        {
          "model": "claude-sonnet-5-5",
          "events": 1200,
          "inputTokens": 36000000,
          "outputTokens": 1600000,
          "cacheCreationInputTokens": 1900000,
          "cacheReadInputTokens": 55000000,
          "tokensBurnt": 41000000
        }
      ],
      "daily": [
        {
          "date": "2026-10-08",
          "tokensBurnt": 3100000,
          "inputTokens": 2700000,
          "outputTokens": 120000,
          "byEmployee": {
            "emp_12ab": 2400000,
            "bot": 700000
          }
        }
      ],
      "employees": [
        {
          "key": "emp_12ab",
          "isBot": false,
          "name": "Sam Okafor",
          "tokensBurnt": 31000000
        },
        {
          "key": "bot",
          "isBot": true,
          "name": "Self Healer",
          "tokensBurnt": 9000000
        }
      ]
    }
  }
}

In the console

The same thing done by hand, for anyone comparing the API against the screen they already use.

Builder → Usage

/builder/usage