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

# View a list of room participants.

`GET /room_sessions/{room_session_id}/participants`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/room_sessions/{room_session_id}/participants`
- Auth: HTTP bearer

Returns a paginated list of participants for the specified room session. Filter participants by join, update, or leave date and by participant context.

## Path parameters

- `room_session_id` string, uuid, required

## Query parameters

- `filter` object
  - `date_joined_at` object
    - `eq` string, date: ISO 8601 date for filtering room participants that joined on that date.
    - `gte` string, date: ISO 8601 date for filtering room participants that joined on or after that date.
    - `lte` string, date: ISO 8601 date for filtering room participants that joined on or before that date.
  - `date_updated_at` object
    - `eq` string, date: ISO 8601 date for filtering room participants updated on that date.
    - `gte` string, date: ISO 8601 date for filtering room participants updated on or after that date.
    - `lte` string, date: ISO 8601 date for filtering room participants updated on or before that date.
  - `date_left_at` object
    - `eq` string, date: ISO 8601 date for filtering room participants that left on that date.
    - `gte` string, date: ISO 8601 date for filtering room participants that left on or after that date.
    - `lte` string, date: ISO 8601 date for filtering room participants that left on or before that date.
  - `context` string: Filter room participants based on the context.
- `page` object
  - `size` integer: The size of the page.
  - `number` integer: The page number to load.

## Response `200`

List room participants response.

- object
  - `data` 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
  - `meta` PaginationMeta
    - `total_pages` integer
    - `total_results` integer
    - `page_number` integer
    - `page_size` integer

## Other responses

- `4XX`: Unexpected error

## Changes

- **2026-10-15** `a72569d69430`: 2 breaking, 2 warning, 1 info
  - the response property `meta/page_number` became optional for the status `200`
  - the response property `meta/total_pages` became optional for the status `200`
  - deleted the `query` request parameter `page[number]`
  - deleted the `query` request parameter `page[size]`
  - …1 more

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/room_sessions/:room_session_id/participants/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/0f17b8167873?raw)