--- title: Fetch details of a participant --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Realtime Kit](https://developers.cloudflare.com/api/python/resources/realtime_kit) [Sessions](https://developers.cloudflare.com/api/python/resources/realtime_kit/subresources/sessions) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Fetch details of a participant realtime\_kit.sessions.get\_session\_participant\_details(strparticipant\_id, SessionGetSessionParticipantDetailsParams\*\*kwargs) -> [SessionGetSessionParticipantDetailsResponse]() GET/accounts/{account\_id}/realtime/kit/{app\_id}/sessions/{session\_id}/participants/{participant\_id} Returns details of the given participant ID for the given session ID. Use the peer report endpoint to retrieve call statistics. ##### Security API Token The preferred authorization scheme for interacting with the Cloudflare API. [Create a token](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/). **Example:**`Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY` ##### Accepted Permissions (at least one required) `Realtime Admin``Realtime` ##### ParametersExpand Collapse account\_id: str The account identifier tag. maxLength32 [Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(method)%20get_session_participant_details%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) app\_id: str The app identifier tag. [Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(method)%20get_session_participant_details%20%3E%20(params)%20default%20%3E%20(param)%20app_id%20%3E%20(schema)>) session\_id: str formatuuid [Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(method)%20get_session_participant_details%20%3E%20(params)%20default%20%3E%20(param)%20session_id%20%3E%20(schema)>) participant\_id: str formatuuid [Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(method)%20get_session_participant_details%20%3E%20(params)%20default%20%3E%20(param)%20participant_id%20%3E%20(schema)>) include\_peer\_events: Optional\[[bool]()] if true, response includes all the peer events of participant. [Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(method)%20get_session_participant_details%20%3E%20(params)%20default%20%3E%20(param)%20include_peer_events%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class SessionGetSessionParticipantDetailsResponse: …
data: Optional\[Data]
participant: Optional\[DataParticipant] id: Optional\[str] Participant ID. This maps to the corresponding peerId. Link to this property created\_at: Optional\[str] timestamp when this participant was created. Link to this property custom\_participant\_id: Optional\[str] ID passed by client to create this participant. Link to this property display\_name: Optional\[str] Display name of participant when joining the session. Link to this property duration: Optional\[float] number of minutes for which the participant was in the session. Link to this property joined\_at: Optional\[str] timestamp at which participant joined the session. Link to this property left\_at: Optional\[str] timestamp at which participant left the session. Link to this property
peer\_events: Optional\[List\[DataParticipantPeerEvent]] Connection lifecycle events for the participant’s peer. Only included when include_peer_events is true. id: Optional\[str] ID of the peer event. Link to this property created\_at: Optional\[str] Timestamp when this peer event was created. Link to this property
event\_name: Optional\[Literal\["PEER\_CREATED", "PEER\_JOINING", "PEER\_LEAVING"]] Name of the peer event. One of the following: "PEER\_CREATED" Link to this property "PEER\_JOINING" Link to this property "PEER\_LEAVING" Link to this property
Link to this property minutes\_consumed: Optional\[float] Minutes consumed attributed to this event. Link to this property participant\_id: Optional\[str] ID of the participant this event belongs to. Link to this property peer\_id: Optional\[str] Peer ID this event belongs to. Link to this property
preset\_view\_type: Optional\[Literal\["GROUP\_CALL", "WEBINAR", "AUDIO\_ROOM", 2 more]] View type of the preset associated with the peer. One of the following: "GROUP\_CALL" Link to this property "WEBINAR" Link to this property "AUDIO\_ROOM" Link to this property "LIVESTREAM" Link to this property "CHAT" Link to this property
Link to this property session\_id: Optional\[str] ID of the session this event belongs to. Link to this property socket\_session\_id: Optional\[str] ID of the socket session associated with this event. Link to this property updated\_at: Optional\[str] Timestamp when this peer event was last updated. Link to this property
Link to this property preset\_name: Optional\[str] Name of the preset associated with the participant. Link to this property updated\_at: Optional\[str] timestamp when this participant’s data was last updated. Link to this property user\_id: Optional\[str] User id for this participant. Link to this property
Link to this property
Link to this property success: Optional\[bool] Link to this property
[Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(model)%20session_get_session_participant_details_response%20%3E%20(schema)>) ### Fetch details of a participant Python HTTPTypeScriptPythonGoTerraform ``` 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_participant_details( participant_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", account_id="023e105f4ecef8ad9ca31a8372d0c353", app_id="14a396e7-ca44-4937-bf1f-050a69118543", session_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", ) print(response.data) ``` 200 example ``` { "data": { "participant": { "id": "id", "created_at": "created_at", "custom_participant_id": "custom_participant_id", "display_name": "display_name", "duration": 0, "joined_at": "joined_at", "left_at": "left_at", "peer_events": [ { "id": "id", "created_at": "created_at", "event_name": "PEER_CREATED", "minutes_consumed": 0, "participant_id": "participant_id", "peer_id": "peer_id", "preset_view_type": "GROUP_CALL", "session_id": "session_id", "socket_session_id": "socket_session_id", "updated_at": "updated_at" } ], "preset_name": "preset_name", "updated_at": "updated_at", "user_id": "user_id" } }, "success": true } ``` ##### Returns Examples 200 example ``` { "data": { "participant": { "id": "id", "created_at": "created_at", "custom_participant_id": "custom_participant_id", "display_name": "display_name", "duration": 0, "joined_at": "joined_at", "left_at": "left_at", "peer_events": [ { "id": "id", "created_at": "created_at", "event_name": "PEER_CREATED", "minutes_consumed": 0, "participant_id": "participant_id", "peer_id": "peer_id", "preset_view_type": "GROUP_CALL", "session_id": "session_id", "socket_session_id": "socket_session_id", "updated_at": "updated_at" } ], "preset_name": "preset_name", "updated_at": "updated_at", "user_id": "user_id" } }, "success": true } ```