GET /api/usage

Retrieve current usage totals for your account. Used by the dashboard with session (cookie) auth.

Request

Called from the dashboard with your session; base URL is your app origin (e.g. https://nascentist.ai).

curl https://nascentist.ai/api/usage \
  -H "Cookie: sb-access-token=..."

Example Response

{
  "plan": "developer",
  "period_start": "2026-03-01T00:00:00Z",
  "period_end": "2026-03-31T23:59:59Z",
  "requests_used": 1240,
  "tokens_used": 389244,
  "requests_limit": 20000,
  "tokens_limit": 5000000
}

Notes

Values are eventually consistent and may lag by a few seconds.
Exhausted limits can return rate_limit_error on write endpoints.