---
search:
  tags:
    - Sessions
    - GET
seo:
  description: >-
    Returns sessions in the workspace, newest first. userId and userDisplayName…
    Reference for the GET /api/v1/sessions endpoint in the torqee Connect API.
sidebar:
  label: List sessions
  badge: GET
title: List sessions
type: openapi-operation
---
Returns sessions in the workspace, newest first. `userId` and `userDisplayName` identify the user who recorded each session. Requires the `torqee:sessions:read` scope.

`GET /api/v1/sessions`

**Responses**

- `200` — Paginated session summaries
- `400` — Invalid pagination parameters
- `401` — Missing or invalid credentials
- `403` — Membership revoked or insufficient scope
- `404` — Tenant database could not be resolved for the workspace
- `500` — Unexpected server error

Response example, 200:

```json
{
  "items": [
    {
      "id": "string",
      "userId": "string",
      "userDisplayName": "string",
      "label": "string",
      "memo": "string",
      "status": "string",
      "startedAt": "string",
      "endedAt": "string",
      "createdAt": "string",
      "updatedAt": "string"
    }
  ],
  "nextCursor": "string"
}
```