Skip to main content

Get Usage

GET 
/v1/usage

Return today's UTC quota usage per endpoint bucket.

Does not consume any rate-limit bucket. A single pass over the 7 Valkey keys is issued via ZCARD (returns 0 for missing keys).

Limits are resolved against the effective tier returned by core.tier.get_api_key_tier — the same 3-value set ("free" / "paid" / "internal") that check_rate_limit uses to enforce per-request caps. The human-facing auth.tier label (from the api_keys.tier column) is preserved in the response's tier field for display. When the two disagree, a usage.tier_drift warning is emitted so production monitoring can detect billing-webhook/admin-tooling skew.

Responses​

Successful Response