Sessions

List and retrieve session data.

List sessions

GET /v1/sessions

Query parameters

Param	Type	Description
userId	string	Filter by user
status	string	active, dropped, stopped
from	ISO date	Start of date range
to	ISO date	End of date range
limit	number	Max results (default: 20, max: 100)

Response

{
  "sessions": [
    {
      "id": "sess_8xK2mP9q",
      "userId": "[e-mail]",
      "score": 94,
      "status": "active",
      "context": "dashboard",
      "startedAt": "2026-04-28T14:32:08Z"
    }
  ],
  "total": 128,
  "cursor": "sess_3mL7zR2x"
}

Get a session

GET /v1/sessions/:id

Response

{
  "id": "sess_8xK2mP9q",
  "userId": "[e-mail]",
  "score": 94,
  "status": "active",
  "context": "dashboard",
  "signals": 1243,
  "interventions": 0,
  "startedAt": "2026-04-28T14:32:08Z",
  "updatedAt": "2026-04-28T14:46:21Z"
}