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

# Get customer usage timeseries

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

Get the usage of a customer for an aggregator bucketed by month, day or hour.

## Path parameters

- `id` string, required
- `aggregator_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.
- `group_by` 'month' | 'day' | 'hour' — Bucket size for the timeseries.

## Response `200`

- CustomerUsageTimeseries
  - `timeseries` object[], required
    - `tick` string, required
    - `count` number, required
  - `total` number, required

## Other responses

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