---
title: "Get room session insights"
method: GET
path: "/insights/room-sessions"
---

# Get room session insights

`GET /insights/room-sessions`

Gets a summary of usage for each session of a given room.

## Query parameters

- `limit` integer

## Response `200`

Array of sorted sessions with their 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.
    - `roomName` string, required — The name of the room.
    - `startedAt` string — The date the session started.
    - `endedAt` string — The date when the session ended.
    - `totalParticipantMinutes` integer, required — The total number of minutes participants have been in the session, rounded up per individual connection.
    - `totalRecorderMinutes` integer, required — The total number of minutes the session was recorded.
    - `totalStreamerMinutes` integer, required — The total number of minutes the session was streamed.
    - `totalUniqueParticipants` integer, required — The total number of distinct participants in the session.
    - `totalUniqueRecorders` integer, required — The total number of distinct recorders in the session.
    - `totalUniqueStreamers` integer, required — The total number of distinct streamers in the session.
    - `rating` unknown
    - `totalRatings` unknown

## 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)