Current unit usage against the plan ceiling
Use when: caller wants the account-level unit meter — units consumed this billing period and over the rolling 30 days, against the plan allowance
Returns the tier, its monthly unit allowance (null for Enterprise), units consumed in the current billing period and over the rolling 30 days, and whether free-tier tracking is currently locked (over-allowance traffic keeps routing and recording but is hidden until upgrade or period reset). Units are tokens processed through the gateway; provider cache reads, failed requests, and Verlon-internal verification traffic never count. Usage never blocks requests and never bills overages — it only informs tier fit.
Authorizations
Verlon API key (newly minted keys are prefixed sk-vrln-; legacy verlon_* and layer_* keys from prior prefix migrations continue to validate). Generated from the dashboard under Settings → API Keys, or via verlon key create in the CLI.
Response
{ tier, ceilingUnits, period: { start, end, units, pctUsed }, rolling30d: { units }, trackingLocked }.

