---
title: "Get Analytics Timeline"
method: GET
path: "/analytics/timeline"
tags: ["Analytics"]
---

# Get Analytics Timeline

`GET /analytics/timeline`

Get time-series analytics data.

Returns session counts, error counts, average duration, and goals
grouped by the specified time granularity.

## Query parameters

- `project_id` string, uuid, nullable — Filter by project ID
- `start_date` string, date-time, nullable — Filter sessions after this date
- `end_date` string, date-time, nullable — Filter sessions before this date
- `granularity` 'day' | 'week' | 'month' — Time grouping granularity
- `version` integer, nullable — Filter by agent version

## Headers

- `x-api-key` string, nullable

## Response `200`

Successful Response

- PublicTimelineAnalytics — Time-series analytics data.
  - `data_points` PublicTimelineDataPoint[], required
    - `date` string, date-time, required
    - `session_count` integer, required
    - `error_count` integer, required
    - `avg_duration_seconds` number, nullable
    - `goals_count` integer, required
    - `version` integer, nullable
  - `granularity` string, required
  - `versions` integer[], required

## Other responses

- `422` — Validation Error

---

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