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

# View a list of room sessions.

`GET /room_sessions`

## Query parameters

- `include_participants` boolean
- `filter` object
  - `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_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.
  - `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.
  - `room_id` string — Room_id for filtering room sessions.
  - `active` boolean — Filter active or inactive room sessions.
- `page[number]` integer
- `page[size]` integer

## Response `200`

List room sessions response.

- object
  - `data` RoomSession[]
    - `id` string, uuid — A unique identifier for the room session.
    - `room_id` string, uuid — Identify the room hosting that room session.
    - `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.
    - `updated_at` string, date-time — ISO 8601 timestamp when the room session was updated.
    - `ended_at` string, date-time — ISO 8601 timestamp when the room session has ended.
    - `participants` RoomParticipant[]
      - `id` string, uuid — A unique identifier for the room participant.
      - `session_id` string, uuid — Identify the room session that participant is part of.
      - `context` string — Context provided to the given participant through the client SDK
      - `joined_at` string, date-time — ISO 8601 timestamp when the participant joined the session.
      - `updated_at` string, date-time — ISO 8601 timestamp when the participant was updated.
      - `left_at` string, date-time — ISO 8601 timestamp when the participant left the session.
      - `record_type` string
    - `record_type` string
  - `meta` PaginationMeta
    - `total_pages` integer, required
    - `total_results` integer
    - `page_number` integer, required
    - `page_size` integer

## Other responses

- `4XX` — Unexpected error

---

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