# List a customer's events (/api/usage/list-usage-events)

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

A customer's events for one UTC day, newest hour first. Kept for 24 months. Events show here up to about 5 minutes after they are counted. `date` is today or earlier, at most 24 months ago. Secret and trusted tokens may call it; a limited token may not (`403`).

## Parameters

- `customer_id` (query, required): Your id for the customer.
- `date` (query, required): One UTC day, YYYY-MM-DD.
- `metric_key` (query): Only this metric's events.
- `limit` (query): 1 to 100, default 100.
- `cursor` (query): next_cursor from the page before.

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

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