---
search:
  tags:
    - Sessions
    - GET
seo:
  description: >-
    Returns session metadata without transcript segments. userId and… Reference
    for the GET /api/v1/sessions/{id} endpoint in the torqee Connect API.
sidebar:
  label: Get a session
  badge: GET
title: Get a session
type: openapi-operation
---
Returns session metadata without transcript segments. `userId` and `userDisplayName` identify the user who recorded the session. Requires the `torqee:sessions:read` scope.

`GET /api/v1/sessions/{id}`

**Responses**

- `200` — Session metadata
- `401` — Missing or invalid credentials
- `403` — Membership revoked or insufficient scope
- `404` — Session not found, or tenant database could not be resolved
- `500` — Unexpected server error

Response example, 200:

```json
{
  "session": {
    "id": "string",
    "userId": "string",
    "userDisplayName": "string",
    "label": "string",
    "memo": "string",
    "status": "string",
    "startedAt": "string",
    "endedAt": "string",
    "createdAt": "string",
    "updatedAt": "string"
  }
}
```