---
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`

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.

---

[API](https://skmtc.net/dyte-io/apis/dyte-rest-apis.md) · [All operations](https://skmtc.net/dyte-io/apis/dyte-rest-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dyte-io/dyte-rest-apis/versions/f62d3edd92ae/schema)