---
title: "Fetch participants list of a session"
method: GET
path: "/sessions/{session_id}/participants"
tags: ["Sessions"]
---

# Fetch participants list of a session

`GET /sessions/{session_id}/participants`

## Request

- Base URL: `https://api.dyte.io/v2`
- URL: `https://api.dyte.io/v2/sessions/{session_id}/participants`
- Auth: HTTP basic

Returns a list of participants for the given session ID.

## Path parameters

- `session_id` string, required

## Query parameters

- `search` string
- `page_no` number
- `per_page` number
- `sort_order` 'ASC' | 'DESC'
- `sort_by` 'joinedAt' | 'duration'
- `include_peer_events` boolean
- `view` 'raw' | 'consolidated'

## Response `200`

Get participants list of a particular session

- object
  - `success` boolean
  - `data` object
    - `participants` ParticipantsList[]
      - `id` string: Participant ID. This maps to the corresponding peerId.
      - `user_id` string: User id for this participant.
      - `custom_participant_id` string: ID passed by client to create this participant.
      - `display_name` string: Display name of participant when joining the session.
      - `preset_name` string: Name of the preset associated with the participant.
      - `joined_at` string: timestamp at which participant joined the session.
      - `left_at` string: timestamp at which participant left the session.
      - `duration` number: number of minutes for which the participant was in the session.
      - `created_at` string: timestamp when this participant was created.
      - `updated_at` string: timestamp when this participant's data was last updated.

## Changes

- **2025-04-04** (v2) `cb67ff854c71`: 1 breaking, 1 info
  - added the new path request parameter `session_id`
  - the endpoint scheme security `Authorization` was added to the API
- **2025-04-03** (v2) `68b9e665bfcc`: 1 warning, 1 info
  - deleted the `path` request parameter `session_id`
  - the endpoint scheme security `Authorization` was removed from the API
- **2024-11-20** (v2) `d8c5d90e84ac`: 2 breaking, 2 info
  - added the new path request parameter `session_id`
  - for the `query` request parameter `include_peer_events`, default value `false` was added
  - the endpoint scheme security `Authorization` was added to the API
  - added the new optional `query` request parameter `view`
- **2023-08-03** (v2) `2f5094919ada`: 1 warning, 1 info
  - removed the optional property `data/participants/items/role` from the response with the `200` status
  - added the optional property `data/participants/items/preset_name` to the response with the `200` status

[Operation history](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/changes/sessions/:session_id/participants/get.md)

---

[API](https://skmtc.dev/dyte-io/apis/dyte-rest-apis.md) - [All operations](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/dyte-io/apis/dyte-rest-apis/revisions/f62d3edd92ae?raw)