---
title: "Get Event Time Series for Charts 📈"
method: GET
path: "/api/v1/events/graph"
tags: ["Events (Clicks)"]
---

# Get Event Time Series for Charts 📈

`GET /api/v1/events/graph`

Get time-series data for app events aggregated by interval (hour/day/week/month). Perfect for creating trading-chart-like visualizations with scrolling and zoom. Filters events by specified tracker(s).

## Query parameters

- `tracker` string[], nullable
- `startDate` string, date-time — Start date for the time series (ISO 8601 format). Required.
- `endDate` string, date-time — End date for the time series (ISO 8601 format). Required.
- `interval` 'year' | 'quarter' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second'

## Response `200`

Successful Response

- AppEventsGraphDTO — Response model for time-series app event analytics
  - `interval` string, required — Time interval used for aggregation
  - `startDate` string, date-time, required
  - `endDate` string, date-time, required
  - `dataPoints` AppEventsGraphDataPoint[], required
    - `timestamp` string, date-time, required
    - `clicks` integer
    - `uniqueClicks` integer
    - `installs` integer
    - `leads` integer
    - `firstSales` integer
    - `repeatedSales` integer
    - `totalEvents` integer
  - `totalDataPoints` integer, required
  - `summary` object, required

## Other responses

- `400` — The request is invalid.
- `404` — The requested resource was not found.
- `422` — Validation Error

## Changes

- **2026-09-02** `060ef67e573a` — 2 breaking
  - for the `query` request parameter `endDate`, default value was changed from `2026-08-31T08:53:06.117511` to `2026-09-02T13:02:40.843545`
  - for the `query` request parameter `startDate`, default value was changed from `2026-08-24T08:53:06.117501` to `2026-08-26T13:02:40.843531`

[Change history](https://skmtc.dev/pwapps/apis/curie-api/changes/api/v1/events/graph/get.md)

---

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