API Reference · Billing

Allocation usage time series

The metered allocation series for the usage chart — one point per hourly sample (summed vCPU / RAM / disk plus the metered overage rate, in cents/month, at that instant). `current` is the latest sample as the live figure (allocation, subscription, mode, pool and prices).

GET/v1/tenants/{name}/usage

Authorization

x-api-keystringrequired
Your per-workspace API key, e.g. llc_AbC123…. Also accepted as Authorization: Bearer <key>. Mint keys on your workspace's API keys page — each key belongs to one workspace.

Path parameters

namestringrequired
Workspace (tenant) name.

Response

200The allocation series and the live current figure.

pointsarray
currentobject
The latest sample as the live figure (null when no samples yet).
curl https://api.live-llm.com/v1/tenants/acme/usage \
  -H "x-api-key: $LIVELLM_KEY"
Try itGEThttps://api.live-llm.com/v1/tenants/{name}/usage
Fill required path param: name.
Example response200
{
  "points": [
    {
      "ts": "2026-08-01T00:00:00Z",
      "cpu": 0.5,
      "ramGi": 0.5,
      "diskGi": 20,
      "overageCents": 0
    },
    {
      "ts": "2026-08-01T01:00:00Z",
      "cpu": 0.5,
      "ramGi": 0.5,
      "diskGi": 20,
      "overageCents": 0
    }
  ],
  "current": {
    "cpu": 0.5,
    "ramGi": 0.5,
    "diskGi": 20
  }
}