Usage API

Read your account’s event usage for the current billing period against the plan limit, with a per-site breakdown. Requires the management key vsk_live_….

Base URL: https://statskit.ai/api/v1

Get usage

GET /usage

curl https://statskit.ai/api/v1/usage \
  -H "Authorization: Bearer vsk_live_..."

Example response

{
  "plan": "Growth",
  "interval": "month",
  "used": 128400,
  "limit": 500000,
  "pct": 26,
  "state": "ok",
  "periodEnd": "2026-07-31",
  "sites": [
    { "name": "versuch.ai", "used": 91200 },
    { "name": "docs.versuch.ai", "used": 37200 }
  ]
}

Field	Meaning
`plan`	Plan name
`interval`	Billing interval (e.g. `month`)
`used`	Events counted this period
`limit`	Plan event limit
`pct`	Percent of the limit used
`state`	Usage state (e.g. `ok`, approaching, over)
`periodEnd`	End of the current billing period (`YYYY-MM-DD`)
`sites`	Per-site event counts