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

# Get aggregator usage

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

Retrieve a usage row for an aggregator (name, unit and thresholds).

## Path parameters

- `id` string, required

## Response `200`

- AggregatorUsage
  - `id` string, required — Aggregator ID.
  - `name` string, required — Display name.
  - `unit_name` string, nullable, required — Unit name (e.g. 'request', 'user').
  - `thresholds` AggregatorUsageThreshold[], required
    - `id` string, required — Threshold ID.
    - `name` string, nullable, required — Threshold name.
    - `value` number, required — Threshold value.
    - `operator` 'gte' | 'lte', required — Comparison operator for the threshold.

## 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)