---
title: "Get aggregator usage grouped by customer"
method: GET
path: "/v1/aggregators/{id}/usage/group-by-customer"
tags: ["Aggregators > Usage"]
---

# Get aggregator usage grouped by customer

`GET /v1/aggregators/{id}/usage/group-by-customer`

Per-customer total usage for an aggregator over a period, ordered by total DESC, paginated.

## 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.
- `aggregator_filter_id` string — Optional aggregator filter ID. When set, restricts the result to events matching that filter's config. Must belong to the aggregator in the path.
- `take` number, nullable
- `skip` number, nullable

## Response `200`

- PaginatedAggregatorUsageGroupByCustomer
  - `meta` object, required
    - `total` number, required — Total of existing items.
    - `taken` number, required — Number of items returned.
    - `skipped` number, required — Number of items skipped.
  - `data` AggregatorUsageGroupByCustomerItem[], required — List of AggregatorUsageGroupByCustomer.
    - `customer_id` string, required — Customer ID.
    - `total` number, required — Customer's total for the period.
    - `subscription_ids` string[], required — IDs of the customer's active subscriptions billing on this aggregator (and matching the filter, when set).

## Other responses

- `404` — Aggregator 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)