> ## Documentation Index
> Fetch the complete documentation index at: https://smithers.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# listUsageReports

> Gateway RPC for listing provider rate-limit and subscription-usage reports.

* Method: `listUsageReports`
* Scope: `account:read`
* Transports: HTTP RPC, WebSocket RPC
* Request: `{ fresh? }`
* Response: `UsageReport[]`

Each report is a normalized provider usage probe for one registered account (see `listAccounts`), shaped by `@smithers-orchestrator/usage`: `{ accountLabel, provider, authMode, source, windows, planType?, credits?, fetchedAt, stale, estimate, error? }`. `windows` lists quota windows as `{ id, label, unit, usedPercent?, used?, limit?, remaining?, resetsAt? }`, the same data `bunx smithers-orchestrator usage` prints.

The Gateway caches reports in memory for 60 seconds; pass `fresh: true` to bypass the cache and re-probe providers. A probe failure sets `error` on that account's report instead of failing the call.

Errors are versioned as `v1` and include `InvalidRequest`, `Unauthorized`, `Forbidden`, and `Internal`.