---
title: "Query analytics, with optional grouping, windowing, filtering."
method: GET
path: "/observability/v1/analytics"
tags: ["Observability"]
---

# Query analytics, with optional grouping, windowing, filtering.

`GET /observability/v1/analytics`

## Query parameters

- `format` 'legacy' | 'agenta'
- `focus` string, nullable
- `oldest` string, nullable
- `newest` string, nullable
- `window` integer, nullable
- `filtering` string, nullable
- `timeRange` string, nullable
- `app_id` string, nullable
- `environment` string, nullable
- `variant` string, nullable

## Response `200`

Successful Response

- union
  - LegacyAnalyticsResponse
    - `total_count` integer, required
    - `failure_rate` number, required
    - `total_cost` number, required
    - `avg_cost` number, required
    - `avg_latency` number, required
    - `total_tokens` integer, required
    - `avg_tokens` number, required
    - `data` LegacyDataPoint[], required
      - `timestamp` string, date-time, required
      - `success_count` integer, required
      - `failure_count` integer, required
      - `cost` number, required
      - `latency` number, required
      - `total_tokens` integer, required
  - AnalyticsResponse
    - `version` string, required
    - `count` integer, nullable
    - `buckets` BucketDTO[], required
      - `timestamp` string, date-time, required
      - `window` integer, required
      - `total` MetricsDTO, required
        - `count` integer, nullable
        - `duration` number, nullable
        - `cost` number, nullable
        - `tokens` integer, nullable
      - `error` MetricsDTO, required
        - `count` integer, nullable
        - `duration` number, nullable
        - `cost` number, nullable
        - `tokens` integer, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2025-06-27** `e3e84db47198` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/observability/v1/analytics/get.md)

---

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