---
title: "Agent Telemetry Series"
method: GET
path: "/v1/agent-telemetry/series"
tags: ["agent-telemetry"]
---

# Agent Telemetry Series

`GET /v1/agent-telemetry/series`

Row volume over time, split by user or API key (standalone).

Mirrors `/v1/usage/series`: same window bounds and bucket-grid cap, the top
groups as their own series with the remainder folded into a reconciling
``other``, and sparse points (populated cells only). Counts rows, not spend,
so it charts telemetry volume rather than cost. Master-key only.

## Query parameters

- `group_by` 'user_id' | 'api_key_id', required — Dimension to split the series by
- `start_date` string, date-time, nullable — Return rows with timestamp >= start_date (ISO 8601 or Unix epoch seconds)
- `end_date` string, date-time, nullable — Return rows with timestamp < end_date (ISO 8601 or Unix epoch seconds)
- `user_id` string[], nullable — Filter to one or more users; repeatable (user_id=a&user_id=b). Several values match any of them. At most 50 per call.
- `api_key_id` string[], nullable — Filter to one or more API key ids; repeatable (api_key_id=a&api_key_id=b). Several values match any of them. At most 50 per call.
- `name` string, nullable — Filter to a single event type or metric name (e.g. 'tool_result', 'claude_code.commit.count')
- `bucket` 'hour' | 'day' — Time-series granularity: 'hour' or 'day'

## Response `200`

Successful Response

- AgentTelemetryGroupedSeries — A per-group row-volume series, for stacked charting.
  - `bucket` 'hour' | 'day', required
  - `end_date` string, required
  - `group_by` 'user_id' | 'api_key_id', required
  - `groups` AgentTelemetryGroupRow[], required
    - `is_other` boolean
    - `key` string, nullable, required
    - `rows` integer, required
  - `points` AgentTelemetryGroupedSeriesPoint[], required
    - `bucket_start` string, required
    - `is_other` boolean
    - `key` string, nullable, required
    - `rows` integer, required
  - `start_date` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mozilla-ai/apis/otari.md) · [All operations](https://skmtc.net/mozilla-ai/apis/otari/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mozilla-ai/otari/revisions/9c654bb5b126/schema)