# Read counted usage (/api/usage/get-usage-summary)

`GET https://api.comecero.com/api/v1/usage/summary`

What the usage meter has counted for one customer and metric, by hour, before it is billed. `from` and `to` are moved to the start of their hour. Kept for 5 minutes. Secret and trusted tokens may call it; a limited token may not (`403`).

## Parameters

- `customer_id` (query, required): Your id for the customer.
- `metric_key` (query, required): The metric's event_key.
- `from` (query, required): A date, from the start of its hour.
- `to` (query, required): A date, not included. At most 366 days after from.

Responses: 200, 400, 401, 403, 429, 500, 502.

Full schemas: operation `get_usage_summary` in /openapi.json.