Sessions & Traffic
Retrieve user session timelines combining traces, logs, and AI spans, plus aggregated device, browser, and traffic analytics from the Trasys Public API.
These endpoints provide deep insights into user sessions, devices, and overall traffic patterns across your application.
All endpoints on this page support standard pagination and time range filtering.
GET /v1/sessions
Retrieve a list of user sessions data with deep filtering.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
device | string | No | Filter by device type. Options: desktop, mobile, tablet. |
browser | string | No | Filter by browser. Options: chrome, firefox, safari, edge. |
| (Pagination) | Supports limit, page, time_range, sort_by, sort_order. |
GET /v1/sessions/:sessionId
Retrieve detailed info for a single session, combining its traces, logs, and AI spans into a single chronological timeline.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
sessionId | string | Yes | The unique identifier of the user session. |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page | integer | No | Page number (0-indexed). |
limit | integer | No | Number of timeline items per page. |
The total items in a session timeline can be extremely large. Ensure you use page and limit to efficiently paginate the timeline. The response meta.total will give you the exact combined total.
GET /v1/traffic
Retrieve traffic analysis and time-series metrics.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
time_range | string | Yes | Time range is required (e.g. 1h, 24h, 7d, 30d). |
interval | string | No | Data aggregation interval. Options: 1m, 1h, 1d. |
Infrastructure & Status
Monitor infrastructure component health, fetch aggregated HTTP traffic metrics, and retrieve the payload needed to render a self-hosted public status page.
TQL Queries
Execute TQL SELECT queries against your traces, logs, metrics, AI spans, and HTTP requests directly through the Trasys Public API's POST /v1/tql endpoint.