Usage Graphs — ML Junction docs

GET /v1/models/{public_model}/usage returns public aggregate request and token history for a model.

Parameter · Accepted values · Default
window_days · 1 through 365 · 30
bucket · hour or day · day

curl "$ASTRO_BASE_URL/v1/models/gpt-5.5/usage?window_days=30&bucket=day"

{
  "object": "list",
  "model": "gpt-5.5",
  "bucket": "day",
  "data": [
    {
      "bucket_start": "2026-06-14T00:00:00Z",
      "requests": 260000,
      "tokens": 134000000
    }
  ]
}

Only observed buckets are returned.. Insert missing buckets as zero client-side only when a continuous chart requires them.. A known model with no activity returns an empty data array.. An unknown model returns 404.. Convert UTC bucket timestamps to the viewer locale only at presentation time.

Canonical URL: https://mljunction.com/docs/usage-graphs