One session's events
Every event in order, paged with a cursor.
An API token from POST /v2/tokens (at_live_...), or a project's secret key (sk_...) for server-side ingest.
In: header
Path Parameters
The project id, as listed by GET /v2/projects.
1 <= lengthThe session id, as listed by the sessions read.
Query Parameters
Rows per page, 1 to 100 (default 20), or up to 1000 with format.
1 <= value <= 1000The opaque nextCursor of the previous page.
1 <= lengthReturns every row as one download instead of a page, up to 1,000,000 rows: csv with a header row and nested fields as dotted columns, json as the normal answer with all rows in data, sql as CREATE TABLE and INSERT statements for Postgres or SQLite. Accept: text/csv also asks for CSV.
Value in
- "csv"
- "json"
- "sql"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/projects/string/sessions/string/events"{ "session": { "id": "f1a2b3c4-d5e6-4f70-8a91-b2c3d4e5f607", "visitor": "8c4e1f0a-2b3c-4d5e-8f60-718293a4b5c6", "startedAt": "2026-09-27T16:38:10.000Z", "durationMs": 109901, "bot": { "score": 0, "reasons": [] } }, "data": [ { "id": "01928c3d-0f10-7b00-8a00-000000000001", "name": "pageview", "ts": "2026-09-27T16:38:10.000Z", "page": { "path": "/", "route": null, "title": null, "referrer": null }, "props": {} }, { "id": "01928c3d-5a20-7b00-8a00-000000000002", "name": "pageview", "ts": "2026-09-27T16:39:02.000Z", "page": { "path": "/projects", "route": null, "title": null, "referrer": null }, "props": {} }, { "id": "01928c3e-7a4b-7c1d-9f00-2b7c1e5d8a11", "name": "pageview", "ts": "2026-09-27T16:39:58.412Z", "page": { "path": "/blog/rebuilding-analytics", "route": null, "title": null, "referrer": null }, "props": {} }, { "id": "01928c3e-7a4c-7a02-8b11-3c8d2f6e9b22", "name": "signup", "ts": "2026-09-27T16:39:59.901Z", "page": { "path": "/blog/rebuilding-analytics", "route": null, "title": null, "referrer": null }, "props": { "plan": "pro" } } ], "nextCursor": null}