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

# Usage And Costs

> Physical usage meters and customer charge reports.

Defined in `openapi/public.openapi.yaml`.

Public operations:

* `GET /api/v1/activity`
* `GET /api/v1/generation`
* `GET /api/v1/usage`
* `GET /api/v1/costs`

Usage is platform-recorded and product-projected. Costs are product ledger charge aggregations.

Key query fields:

* `start_time`
* `end_time`
* `granularity`
* `api_key_hash`
* `model`

June 4 dependencies:

* account/key-level usage aggregation;
* 5-minute usage granularity.

`/usage` returns physical meters only. `/costs` returns customer-facing charges. Public APIs must not expose provider/internal cost.
