Spoar
Dev widget

Live sessions

GET
/v2/projects/{project}/realtime/sessions

One row per session with an event in the last five minutes, most recently active first: the visitor, the last 20 pages in order, pageviews, events, duration, referrer, place, device, the highest bot score and signal: bot from 50, suspect from 25, engaged from three pageviews or a minute, else human. limit from 1 to 200, default 50.

Authorization

AuthorizationBearer <token>

An API token from POST /v2/tokens (at_live_...), or a project's secret key (sk_...) for server-side ingest.

In: header

Path Parameters

project*string

The project id, as listed by GET /v2/projects.

Length1 <= length

Query Parameters

limit?string

Rows to return, from 1 to 200; 50 by default.

Match^[0-9]+$

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/realtime/sessions"
{  "data": [    {      "id": "f1a2b3c4-d5e6-4f70-8a91-b2c3d4e5f607",      "visitor": "8c4e1f0a-2b3c-4d5e-8f60-718293a4b5c6",      "startedAt": "2026-10-03T13:59:12.000Z",      "lastSeen": "2026-10-03T14:02:04.117Z",      "trail": [        "/",        "/pricing",        "/quote"      ],      "pages": 3,      "events": 5,      "durationMs": 172117,      "referrer": "https://www.google.com/",      "country": "NL",      "device": "mobile",      "botScore": 0,      "signal": "engaged"    }  ],  "window": {    "from": "2026-10-03T13:57:04.117Z",    "to": "2026-10-03T14:02:04.117Z"  }}