---
title: "View a list of room sessions."
method: GET
path: "/room_sessions"
tags: ["Room Sessions"]
---

# View a list of room sessions.

`GET /room_sessions`

Returns a paginated list of room sessions across the account. Filter sessions by room, creation, update, or end date and active status, and use `include_participants` to include participant records.

## Query parameters

- `include_participants` boolean
- `filter` object
  - `active` boolean — Filter active or inactive room sessions.
  - `date_created_at` object
    - `eq` string, date — ISO 8601 date for filtering room sessions created on that date.
    - `gte` string, date — ISO 8601 date for filtering room sessions created on or after that date.
    - `lte` string, date — ISO 8601 date for filtering room sessions created on or before that date.
  - `date_ended_at` object
    - `eq` string, date — ISO 8601 date for filtering room sessions ended on that date.
    - `gte` string, date — ISO 8601 date for filtering room sessions ended on or after that date.
    - `lte` string, date — ISO 8601 date for filtering room sessions ended on or before that date.
  - `date_updated_at` object
    - `eq` string, date — ISO 8601 date for filtering room sessions updated on that date.
    - `gte` string, date — ISO 8601 date for filtering room sessions updated on or after that date.
    - `lte` string, date — ISO 8601 date for filtering room sessions updated on or before that date.
  - `room_id` string — Room_id for filtering room sessions.
- `page` object
  - `number` integer — The page number to load.
  - `size` integer — The size of the page.

## Response `200`

List room sessions response.

- object
  - `data` RoomSession[]
    - `active` boolean — Shows if the room session is active or not.
    - `created_at` string, date-time — ISO 8601 timestamp when the room session was created.
    - `ended_at` string, date-time — ISO 8601 timestamp when the room session has ended.
    - `id` string, uuid — A unique identifier for the room session.
    - `participants` RoomParticipant[]
      - `context` string — Context provided to the given participant through the client SDK
      - `id` string, uuid — A unique identifier for the room participant.
      - `joined_at` string, date-time — ISO 8601 timestamp when the participant joined the session.
      - `left_at` string, date-time — ISO 8601 timestamp when the participant left the session.
      - `record_type` string
      - `session_id` string, uuid — Identify the room session that participant is part of.
      - `updated_at` string, date-time — ISO 8601 timestamp when the participant was updated.
    - `record_type` string
    - `room_id` string, uuid — Identify the room hosting that room session.
    - `updated_at` string, date-time — ISO 8601 timestamp when the room session was updated.
  - `meta` PaginationMeta
    - `page_number` integer
    - `page_size` integer
    - `total_pages` integer
    - `total_results` integer

## Other responses

- `4XX` — Unexpected error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api-2/revisions/1571b0380bd7/schema)