> ## Documentation Index
> Fetch the complete documentation index at: https://onlook.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Sessions

> List and retrieve session data.

## List sessions

```bash theme={null}
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**

```json theme={null}
{
  "sessions": [
    {
      "id": "sess_8xK2mP9q",
      "userId": "alice@acme.com",
      "score": 94,
      "status": "active",
      "context": "dashboard",
      "startedAt": "2026-04-28T14:32:08Z"
    }
  ],
  "total": 128,
  "cursor": "sess_3mL7zR2x"
}
```

## Get a session

```bash theme={null}
GET /v1/sessions/:id
```

**Response**

```json theme={null}
{
  "id": "sess_8xK2mP9q",
  "userId": "alice@acme.com",
  "score": 94,
  "status": "active",
  "context": "dashboard",
  "signals": 1243,
  "interventions": 0,
  "startedAt": "2026-04-28T14:32:08Z",
  "updatedAt": "2026-04-28T14:46:21Z"
}
```