Skip to main content
GET /api/v1/usage Requires usage.read permission. Returns aggregated metric counts broken down by environment and time period.

​
Response

​
usage
UsageRollup[]
required
Array of usage rollup entries.

​
Errors

StatusWhen
401Missing or invalid Bearer token
403Caller lacks usage.read permission

​
Example

curl http://localhost:8080/api/v1/usage \
  -H "Authorization: Bearer <token>"

{
  "usage": [
    {
      "metric": "evaluations",
      "environment_id": "e1a2b3c4-d5e6-7890-abcd-ef1234567890",
      "period_start": "2026-03-21T00:00:00Z",
      "period_granularity": "day",
      "count": 84210
    }
  ]
}

Build docs developers (and LLMs) love

Get started for freeTalk to us