Get Usage V1

Tenant-scoped usage rollup. Returns lifetime totals (tokens, cost, job count), the by-status job breakdown, and current billing-period spend + quota state…

GET /api/v1/usage

cURL

curl --request GET \
  --url 'https://api.computer.stateset.app/api/v1/usage' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"

200

{
  "total_jobs": 1,
  "total_tokens": 1,
  "total_cost_usd": 1.5,
  "period_tasks_used": 1,
  "task_quota": 1,
  "period_cost_usd": 1.5,
  "by_status": {},
  "billing_period_start": "string",
  "billing_period_end": "string"
}

Tenant-scoped usage rollup.

Returns lifetime totals (tokens, cost, job count), the by-status job breakdown, and current billing-period spend + quota state. Useful for dashboards and pre-flight checks before queueing a large batch.

Response

app__api__routes__v1__trigger__UsageResponse

total_jobs · integer · required

total_tokens · integer · required

total_cost_usd · number · required

period_tasks_used · integer · required

task_quota · integer · required

period_cost_usd · number · required

by_status · object · required

billing_period_start · string,null · required

billing_period_end · string,null · required

Status codes

Code	Meaning
200	Successful Response

cURL

curl --request GET \
  --url 'https://api.computer.stateset.app/api/v1/usage' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"

200

{
  "total_jobs": 1,
  "total_tokens": 1,
  "total_cost_usd": 1.5,
  "period_tasks_used": 1,
  "task_quota": 1,
  "period_cost_usd": 1.5,
  "by_status": {},
  "billing_period_start": "string",
  "billing_period_end": "string"
}