--- title: Fetch all sessions of an App --- [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 all sessions of an App realtime\_kit.sessions.get\_sessions(strapp\_id, SessionGetSessionsParams\*\*kwargs) -> [SessionGetSessionsResponse]() GET/accounts/{account\_id}/realtime/kit/{app\_id}/sessions Returns details of all sessions of an App. ##### 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_sessions%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_sessions%20%3E%20(params)%20default%20%3E%20(param)%20app_id%20%3E%20(schema)>) associated\_id: Optional\[str] ID of the meeting that sessions should be associated with formatuuid [Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(method)%20get_sessions%20%3E%20(params)%20default%20%3E%20(param)%20associated_id%20%3E%20(schema)>) end\_time: Optional\[Union\[str, datetime]] The end time range for which you want to retrieve the meetings. The time must be specified in ISO format. formatdate-time [Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(method)%20get_sessions%20%3E%20(params)%20default%20%3E%20(param)%20end_time%20%3E%20(schema)>) page\_no: Optional\[float] The page number from which you want your page search results to be displayed. minimum0 [Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(method)%20get_sessions%20%3E%20(params)%20default%20%3E%20(param)%20page_no%20%3E%20(schema)>) participants: Optional\[str] [Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(method)%20get_sessions%20%3E%20(params)%20default%20%3E%20(param)%20participants%20%3E%20(schema)>) per\_page: Optional\[float] Number of results per page minimum0 [Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(method)%20get_sessions%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) search: Optional\[str] Search string that matches sessions based on meeting title, meeting ID, and session ID [Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(method)%20get_sessions%20%3E%20(params)%20default%20%3E%20(param)%20search%20%3E%20(schema)>)

sort\_by: Optional\[Literal\["minutesConsumed", "createdAt"]]

One of the following: "minutesConsumed" Link to this property "createdAt" Link to this property

[Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(method)%20get_sessions%20%3E%20(params)%20default%20%3E%20(param)%20sort_by%20%3E%20(schema)>)

sort\_order: Optional\[Literal\["ASC", "DESC"]]

One of the following: "ASC" Link to this property "DESC" Link to this property

[Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(method)%20get_sessions%20%3E%20(params)%20default%20%3E%20(param)%20sort_order%20%3E%20(schema)>) start\_time: Optional\[Union\[str, datetime]] The start time range for which you want to retrieve the meetings. The time must be specified in ISO format. formatdate-time [Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(method)%20get_sessions%20%3E%20(params)%20default%20%3E%20(param)%20start_time%20%3E%20(schema)>)

status: Optional\[Literal\["LIVE", "ENDED"]]

One of the following: "LIVE" Link to this property "ENDED" Link to this property

[Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(method)%20get_sessions%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)>) ##### ReturnsExpand Collapse

class SessionGetSessionsResponse: …

data: Optional\[Data]

sessions: Optional\[List\[DataSession]]

id: str ID of the session Link to this property associated\_id: str ID of the meeting this session is associated with. In the case of V2 meetings, it is always a UUID. In V1 meetings, it is a room name of the form abcdef-ghijkl Link to this property created\_at: str timestamp when session created Link to this property live\_participants: float number of participants currently in the session Link to this property max\_concurrent\_participants: float number of maximum participants that were in the session Link to this property meeting\_display\_name: str Title of the meeting this session belongs to Link to this property minutes\_consumed: float number of minutes consumed since the session started Link to this property organization\_id: str App id that hosted this session Link to this property started\_at: str timestamp when session started Link to this property

status: Literal\["LIVE", "ENDED"] current status of session

One of the following: "LIVE" Link to this property "ENDED" Link to this property

Link to this property

type: Literal\["meeting", "livestream", "participant"] type of session

One of the following: "meeting" Link to this property "livestream" Link to this property "participant" Link to this property

Link to this property updated\_at: str timestamp when session was last updated Link to this property breakout\_rooms: Optional\[List\[object]] Link to this property ended\_at: Optional\[str] timestamp when session ended Link to this property

Link to this property

paging: Optional\[Paging]

end\_offset: Optional\[float] Link to this property start\_offset: Optional\[float] Link to this property total\_count: Optional\[float] minimum0 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_sessions_response%20%3E%20(schema)>) ### Fetch all sessions of an App 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_sessions( app_id="14a396e7-ca44-4937-bf1f-050a69118543", account_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(response.data) ``` 200 example ``` { "data": { "sessions": [ { "id": "id", "associated_id": "associated_id", "created_at": "created_at", "live_participants": 0, "max_concurrent_participants": 0, "meeting_display_name": "meeting_display_name", "minutes_consumed": 0, "organization_id": "organization_id", "started_at": "started_at", "status": "LIVE", "type": "meeting", "updated_at": "updated_at", "breakout_rooms": [ {} ], "ended_at": "ended_at" } ] }, "paging": { "end_offset": 0, "start_offset": 0, "total_count": 0 }, "success": true } ``` ##### Returns Examples 200 example ``` { "data": { "sessions": [ { "id": "id", "associated_id": "associated_id", "created_at": "created_at", "live_participants": 0, "max_concurrent_participants": 0, "meeting_display_name": "meeting_display_name", "minutes_consumed": 0, "organization_id": "organization_id", "started_at": "started_at", "status": "LIVE", "type": "meeting", "updated_at": "updated_at", "breakout_rooms": [ {} ], "ended_at": "ended_at" } ] }, "paging": { "end_offset": 0, "start_offset": 0, "total_count": 0 }, "success": true } ```