---
title: "List customer usage"
method: GET
path: "/v1/customers/{id}/usage"
tags: ["Customers > Usage"]
---

# List customer usage

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

List one usage row per aggregator for a single customer over a period. Use `GET /v1/aggregators/{id}/usage/group-by-customer` for the inverse: one row per customer for a single aggregator.

## Path parameters

- `id` string, required

## Query parameters

- `start_date` string, date-time, required — ISO-8601 date string.
- `end_date` string, date-time, required — ISO-8601 date string.

## Response `200`

- CustomerUsageItem[]
  - `aggregator_id` string, required — Aggregator ID.
  - `name` string, required — Display name.
  - `unit_name` string, nullable, required — Unit name.
  - `total` number, required — Total usage over the period.
  - `count` number, required — Number of events behind the total.

## Other responses

- `404` — Customer not found

---

[API](https://skmtc.dev/hyperline/apis/hyperline-api.md) · [All operations](https://skmtc.dev/hyperline/apis/hyperline-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hyperline/hyperline-api/revisions/19fa5f22e39b/schema)