## Fetch participants list of a session

`realtime_kit.sessions.get_session_participants(strsession_id, SessionGetSessionParticipantsParams**kwargs)  -> SessionGetSessionParticipantsResponse`

**get** `/accounts/{account_id}/realtime/kit/{app_id}/sessions/{session_id}/participants`

Returns a list of participants for the given session ID.

### Parameters

- `account_id: str`

  The account identifier tag.

- `app_id: str`

  The app identifier tag.

- `session_id: str`

- `include_peer_events: Optional[bool]`

  if true, response includes all the peer events of participants.

- `page_no: Optional[float]`

  The page number from which you want your page search results to be displayed.

- `per_page: Optional[float]`

  Number of results per page

- `search: Optional[str]`

  The search query string. You can search using the meeting ID or title.

- `sort_by: Optional[Literal["joinedAt", "duration"]]`

  - `"joinedAt"`

  - `"duration"`

- `sort_order: Optional[Literal["ASC", "DESC"]]`

  - `"ASC"`

  - `"DESC"`

- `view: Optional[Literal["raw", "consolidated"]]`

  In breakout room sessions, the view parameter can be set to `raw` for session specific duration for participants or `consolidated` to accumulate breakout room durations.

  - `"raw"`

  - `"consolidated"`

### Returns

- `class SessionGetSessionParticipantsResponse: …`

  - `data: Optional[Data]`

    - `participants: Optional[List[DataParticipant]]`

      - `id: Optional[str]`

        Participant ID. This maps to the corresponding peerId.

      - `created_at: Optional[str]`

        timestamp when this participant was created.

      - `custom_participant_id: Optional[str]`

        ID passed by client to create this participant.

      - `display_name: Optional[str]`

        Display name of participant when joining the session.

      - `duration: Optional[float]`

        number of minutes for which the participant was in the session.

      - `joined_at: Optional[str]`

        timestamp at which participant joined the session.

      - `left_at: Optional[str]`

        timestamp at which participant left the session.

      - `preset_name: Optional[str]`

        Name of the preset associated with the participant.

      - `updated_at: Optional[str]`

        timestamp when this participant's data was last updated.

      - `user_id: Optional[str]`

        User id for this participant.

  - `success: Optional[bool]`

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
response = client.realtime_kit.sessions.get_session_participants(
    session_id="session_id",
    account_id="023e105f4ecef8ad9ca31a8372d0c353",
    app_id="app_id",
)
print(response.data)
```

#### Response

```json
{
  "data": {
    "paging": {
      "end_offset": 2,
      "start_offset": 1,
      "total_count": 123
    },
    "participants": [
      {
        "created_at": "2023-02-01T10:51:08.039Z",
        "custom_participant_id": "83qi0i",
        "display_name": "Mark",
        "duration": 5.8097,
        "id": "005f4e0c-4d08-4d4e-a391-a76be75cd296",
        "joined_at": "2023-02-01T10:51:08.030Z",
        "left_at": "2023-02-01T10:56:56.612Z",
        "preset_name": "webinar_participant",
        "updated_at": "2023-02-01T10:56:56.618Z",
        "user_id": "0a08343d-a9dc-45f0-9feb-6a64afcc4f81"
      },
      {
        "created_at": "2023-02-01T10:50:36.853Z",
        "custom_participant_id": "3uggr",
        "display_name": "Henry",
        "duration": 6.9263,
        "id": "51fdf95f-d893-471a-922b-7db7adb14453",
        "joined_at": "2023-02-01T10:50:36.846Z\"",
        "left_at": "2023-02-01T10:57:32.424Z",
        "preset_name": "webinar_participant",
        "updated_at": "2023-02-01T10:57:32.431Z",
        "user_id": "85e7f0fd-7c16-45e9-9d68-f17ef007c4eb"
      }
    ]
  },
  "success": true
}
```