---
title: "Get participants"
method: GET
path: "/insights/participants"
---

# Get participants

`GET /insights/participants`

Gets a list of participants, by either a given session id or external id.

## Query parameters

- `limit` integer

## Response `200`

Array of sorted sessions participants with insights.

- object
  - `cursor` string — The cursor for paginating through the results. To fetch the next page, set the `cursor` to the `cursor` returned by the previous request. If there are no more results, the value returned is `null`.
  - `results` object[]
    - `roomSessionId` string, required — The identifier of the session.
    - `participantId` string, required — The identifier of the participant.
    - `deviceId` string, required — The identifier of the device.
    - `userId` string, required — The identifier of the user.
    - `roleName` string, required — The role name of the participant.
    - `displayName` string, required — The display name of the participant.
    - `joinedAt` string, required — The timestamp the participant joined the session.
    - `leftAt` string, required — The timestamp the participant left the session.
    - `externalId` string, required — The external identifier of the participant.
    - `rating` unknown
    - `tags` string[] — Tags the participant selected (e.g. issue categories). Requires session ratings to be enabled for the organization.
    - `comment` string — Free-text comment from the participant. Requires session ratings to be enabled for the organization.

## Other responses

- `401` — Access token is missing or invalid
- `429` — You are rate limited

---

[API](https://skmtc.net/whereby/apis/whereby-rest-api.md) · [All operations](https://skmtc.net/whereby/apis/whereby-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whereby/whereby-rest-api/revisions/3d9aec0774ff/schema)