# Get customer usage history (https://docs.billwave.example/api-reference/getCustomerUsageHistory)

Returns aggregated usage history for a customer, optionally filtered by feature and grouped for breakdown views. Accepts the internal ID, your external customer ID, or the customer's email.

---

## API operations

- `GET /v1/customers/{id}/usage/history`

Full request and response schemas: https://docs.billwave.example/openapi.json