Skip to main content
GET
Per-key usage rollup

Path Parameters

key_prefix
string
required

Response

Usage rollup (zeros when no rows yet)

GET /v1/keys/{key_prefix}/usage - rolled-up per-key counters.

Values are aggregated nightly from runtime_events into the key_usage_daily table (migration 043). Returns zeros for any window that has no rolled-up data yet - a brand-new key legitimately has zero requests, and returning 404 would force the dashboard into a special-case render path.

requests_24h
integer
default:0
requests_7d
integer
default:0
requests_30d
integer
default:0
requests_90d
integer
default:0
tokens_30d
integer
default:0
error_rate_30d
number
default:0