---
title: "Get room insights"
method: GET
path: "/insights/rooms"
---

# Get room insights

`GET /insights/rooms`

Gets a summary of insights collected for rooms.

## Query parameters

- `roomName` object
  - `exact` string — Example: roomName[exact]=/room-prefix-793e9ec1-c686-423d-9043-9b7a10c553fd
  - `startsWith` string — Example: roomName[startsWith]=/room-prefix
  - `contains` string — Example: roomName[contains]=793e9ec1
- `createdAt` object
  - `from` string, date-time — Example: createdAt[from]=2025-01-01T00:00:00.000Z
  - `to` string, date-time — Example: createdAt[to]=2025-05-01T00:01:00.000Z
- `limit` integer

## Response `200`

Array of sorted rooms 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[]
    - `roomName` string, required — The name of the room.
    - `createdAt` string, required — The date the room was created.
    - `endAt` string, required — The date the room was set to expire.
    - `firstSessionStartedAt` string, required — The date the first session started in this room.
    - `lastSessionStartedAt` string, required — The date the last session started in this room.
    - `totalParticipantMinutes` integer, required — The total number of minutes participants have been in the room, rounded up per individual connection.
    - `totalRecorderMinutes` integer, required — The total number of minutes the room was recorded.
    - `totalStreamerMinutes` integer, required — The total number of minutes the room was streamed.
    - `totalUniqueParticipants` integer, required — The total number of distinct participants in the room.
    - `totalUniqueRecorders` integer, required — The total number of distinct recorders in the room.
    - `totalUniqueStreamers` integer, required — The total number of distinct streamers in the room.
    - `totalSessions` integer, required — The total number of sessions in the room.
    - `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)