---
title: "Get Session Timeseries"
method: GET
path: "/v3/sessions/timeseries"
tags: ["Sessions"]
---

# Get Session Timeseries

`GET /v3/sessions/timeseries`

Returns timeseries data for sessions, optionally grouped by a field.
Useful for visualizing session volume over time and identifying trends.

## Query parameters

- `scope` 'workspace' | 'demo'
- `start_time` string, date-time, required
- `end_time` string, date-time, required
- `query` string
- `field` string
- `size` integer
- `interval` 'auto' | '1s' | '1m' | '1h' | '1d'

## Response `200`

OK - request successful.

- SessionTimeseriesResponse
  - `timeseries` SessionTimeseriesPoint[] — Timeseries data points (when no field grouping is used).
    - `timestamp` string — Timestamp for this data point.
    - `count` integer — Number of sessions in this time bucket.
  - `items` SessionTimeseriesItem[] — Grouped timeseries data (when field grouping is used).
    - `label` string — The field value for this group.
    - `count` integer — Total sessions for this group.
    - `timeseries` SessionTimeseriesPoint[] — Timeseries data for this group.
      - `timestamp` string — Timestamp for this data point.
      - `count` integer — Number of sessions in this time bucket.
  - `total` integer — Total number of sessions in the time range.
  - `request_metadata` object
    - `start_time` string
    - `end_time` string
    - `query` string
    - `field` string
    - `interval` string

## Other responses

- `400` — Bad request - request syntax is invalid for the specified endpoint. Verify request syntax and try again.
- `401` — Unauthorized. Please check your API key.
- `403` — Forbidden - request is not authorized due to an invalid API key or plan limitations. If due to plan limitations, contact sales@greynoise.io to upgrade your plan and unlock full results.
- `429` — Too many requests. You've hit the rate-limit.
- `500` — Unexpected error

---

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