Get Usage Trend V1

Daily cost / token / job-count trend. Returns a zero-filled per-day rollup so dashboards can render a sparkline without client-side gap-filling…

GET /api/v1/usage/trend

cURL

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

200

{
  "period": "string",
  "start_date": "2026-08-31T14:22:05Z",
  "end_date": "2026-08-31T14:22:05Z",
  "buckets": [
    {
      "date": "2026-08-31T14:22:05Z",
      "jobs": 1,
      "tokens": 1,
      "cost_usd": 1.5
    }
  ]
}

Daily cost / token / job-count trend.

Returns a zero-filled per-day rollup so dashboards can render a sparkline without client-side gap-filling. Always uses UTC calendar days; same-day usage records are aggregated regardless of when in the day they landed.

Query parameters

period · string

Window length. One of 7d / 30d / 90d.

Response

UsageTrendResponse

period · string · required

The window queried (‘7d’, ‘30d’, ‘90d’).

start_date · string · required

end_date · string · required

buckets · UsageTrendBucket[] · required

Day-by-day rollup, oldest first, with zero-filled rows for dates that had no activity. Length always equals the period in days.

Show UsageTrendBucket

date · string · required

ISO 8601 calendar date (UTC).

jobs · integer · required

Count of billed runs that completed on this day.

tokens · integer · required

Sum of input + output tokens.

cost_usd · number · required

Total billed cost in USD.

Status codes

Code	Meaning
200	Successful Response
422	Validation Error

cURL

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

200

{
  "period": "string",
  "start_date": "2026-08-31T14:22:05Z",
  "end_date": "2026-08-31T14:22:05Z",
  "buckets": [
    {
      "date": "2026-08-31T14:22:05Z",
      "jobs": 1,
      "tokens": 1,
      "cost_usd": 1.5
    }
  ]
}