--- title: Livestreams --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Realtime Kit](https://developers.cloudflare.com/api/python/resources/realtime_kit) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Livestreams ##### [Fetch all livestreams](https://developers.cloudflare.com/api/python/resources/realtime_kit/subresources/livestreams/methods/get_all_livestreams) realtime\_kit.livestreams.get\_all\_livestreams(strapp\_id, LivestreamGetAllLivestreamsParams\*\*kwargs) -> [LivestreamGetAllLivestreamsResponse]() GET/accounts/{account\_id}/realtime/kit/{app\_id}/livestreams ##### [Stop livestreaming a meeting](https://developers.cloudflare.com/api/python/resources/realtime_kit/subresources/livestreams/methods/stop_livestreaming_a_meeting) realtime\_kit.livestreams.stop\_livestreaming\_a\_meeting(strmeeting\_id, LivestreamStopLivestreamingAMeetingParams\*\*kwargs) -> [LivestreamStopLivestreamingAMeetingResponse]() POST/accounts/{account\_id}/realtime/kit/{app\_id}/meetings/{meeting\_id}/active-livestream/stop ##### [Start livestreaming a meeting](https://developers.cloudflare.com/api/python/resources/realtime_kit/subresources/livestreams/methods/start_livestreaming_a_meeting) realtime\_kit.livestreams.start\_livestreaming\_a\_meeting(strmeeting\_id, LivestreamStartLivestreamingAMeetingParams\*\*kwargs) -> [LivestreamStartLivestreamingAMeetingResponse]() POST/accounts/{account\_id}/realtime/kit/{app\_id}/meetings/{meeting\_id}/livestreams ##### [Fetch complete analytics data for your livestreams](https://developers.cloudflare.com/api/python/resources/realtime_kit/subresources/livestreams/methods/get_livestream_analytics_complete) realtime\_kit.livestreams.get\_livestream\_analytics\_complete(strapp\_id, LivestreamGetLivestreamAnalyticsCompleteParams\*\*kwargs) -> [LivestreamGetLivestreamAnalyticsCompleteResponse]() GET/accounts/{account\_id}/realtime/kit/{app\_id}/analytics/livestreams/overall ##### [Fetch day-wise analytics data for your livestreams](https://developers.cloudflare.com/api/python/resources/realtime_kit/subresources/livestreams/methods/get_livestream_analytics_daywise) realtime\_kit.livestreams.get\_livestream\_analytics\_daywise(strapp\_id, LivestreamGetLivestreamAnalyticsDaywiseParams\*\*kwargs) -> [LivestreamGetLivestreamAnalyticsDaywiseResponse]() GET/accounts/{account\_id}/realtime/kit/{app\_id}/analytics/livestreams/daywise ##### [Fetch day-wise session and recording analytics data for an App](https://developers.cloudflare.com/api/python/resources/realtime_kit/subresources/livestreams/methods/get_org_analytics) realtime\_kit.livestreams.get\_org\_analytics(strapp\_id, LivestreamGetOrgAnalyticsParams\*\*kwargs) -> [LivestreamGetOrgAnalyticsResponse]() GET/accounts/{account\_id}/realtime/kit/{app\_id}/analytics/daywise ##### [Fetch active livestreams for a meeting](https://developers.cloudflare.com/api/python/resources/realtime_kit/subresources/livestreams/methods/get_meeting_active_livestreams) realtime\_kit.livestreams.get\_meeting\_active\_livestreams(strmeeting\_id, LivestreamGetMeetingActiveLivestreamsParams\*\*kwargs) -> [LivestreamGetMeetingActiveLivestreamsResponse]() GET/accounts/{account\_id}/realtime/kit/{app\_id}/meetings/{meeting\_id}/active-livestream ##### [Fetch livestream session details using livestream session ID](https://developers.cloudflare.com/api/python/resources/realtime_kit/subresources/livestreams/methods/get_livestream_session_details_for_session_id) realtime\_kit.livestreams.get\_livestream\_session\_details\_for\_session\_id(strlivestream\_session\_id, LivestreamGetLivestreamSessionDetailsForSessionIDParams\*\*kwargs) -> [LivestreamGetLivestreamSessionDetailsForSessionIDResponse]() GET/accounts/{account\_id}/realtime/kit/{app\_id}/livestreams/sessions/{livestream-session-id} ##### [Fetch active livestream session details](https://developers.cloudflare.com/api/python/resources/realtime_kit/subresources/livestreams/methods/get_active_livestreams_for_livestream_id) realtime\_kit.livestreams.get\_active\_livestreams\_for\_livestream\_id(strlivestream\_id, LivestreamGetActiveLivestreamsForLivestreamIDParams\*\*kwargs) -> [LivestreamGetActiveLivestreamsForLivestreamIDResponse]() GET/accounts/{account\_id}/realtime/kit/{app\_id}/livestreams/{livestream\_id}/active-livestream-session ##### [Fetch livestream details using livestream ID](https://developers.cloudflare.com/api/python/resources/realtime_kit/subresources/livestreams/methods/get_livestream_session_for_livestream_id) realtime\_kit.livestreams.get\_livestream\_session\_for\_livestream\_id(strlivestream\_id, LivestreamGetLivestreamSessionForLivestreamIDParams\*\*kwargs) -> [LivestreamGetLivestreamSessionForLivestreamIDResponse]() GET/accounts/{account\_id}/realtime/kit/{app\_id}/livestreams/{livestream\_id} ##### ModelsExpand Collapse
class LivestreamGetAllLivestreamsResponse: …
data: Optional\[Data] id: Optional\[str] The ID of the livestream. formatuuid Link to this property created\_at: Optional\[datetime] Timestamp the object was created at. The time is returned in ISO format. formatdate-time Link to this property disabled: Optional\[str] Specifies if the livestream was disabled. Link to this property ingest\_server: Optional\[str] The server URL to which the RTMP encoder sends the video and audio data. Link to this property meeting\_id: Optional\[str] ID of the meeting. Link to this property name: Optional\[str] Name of the livestream. Link to this property
paging: Optional\[DataPaging] end\_offset: Optional\[int] Link to this property start\_offset: Optional\[int] Link to this property total\_count: Optional\[int] Link to this property
Link to this property playback\_url: Optional\[str] The web address that viewers can use to watch the livestream. Link to this property
status: Optional\[Literal\["LIVE", "IDLE", "ERRORED", "INVOKED"]] One of the following: "LIVE" Link to this property "IDLE" Link to this property "ERRORED" Link to this property "INVOKED" Link to this property
Link to this property stream\_key: Optional\[str] Unique key for accessing each livestream. Link to this property updated\_at: Optional\[datetime] Timestamp the object was updated at. The time is returned in ISO format. formatdate-time Link to this property
Link to this property success: Optional\[bool] Link to this property
[Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(model)%20livestream_get_all_livestreams_response%20%3E%20(schema)>)
class LivestreamStopLivestreamingAMeetingResponse: …
data: Optional\[Data] message: Optional\[str] Link to this property
Link to this property success: Optional\[bool] Link to this property
[Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(model)%20livestream_stop_livestreaming_a_meeting_response%20%3E%20(schema)>)
class LivestreamStartLivestreamingAMeetingResponse: …
data: Optional\[Data] id: Optional\[str] The livestream ID. Link to this property ingest\_server: Optional\[str] The server URL to which the RTMP encoder sends the video and audio data. Link to this property playback\_url: Optional\[str] The web address that viewers can use to watch the livestream. Link to this property
status: Optional\[Literal\["LIVE", "IDLE", "ERRORED", "INVOKED"]] One of the following: "LIVE" Link to this property "IDLE" Link to this property "ERRORED" Link to this property "INVOKED" Link to this property
Link to this property stream\_key: Optional\[str] Unique key for accessing each livestream. Link to this property
Link to this property success: Optional\[bool] Link to this property
[Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(model)%20livestream_start_livestreaming_a_meeting_response%20%3E%20(schema)>)
class LivestreamGetLivestreamAnalyticsCompleteResponse: …
data: Optional\[Data] count: Optional\[int] Count of total livestreams. Link to this property total\_ingest\_seconds: Optional\[int] Total time duration for which the input was given or the meeting was streamed. Link to this property total\_viewer\_seconds: Optional\[int] Total view time for which the viewers watched the stream. Link to this property
Link to this property success: Optional\[bool] Link to this property
[Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(model)%20livestream_get_livestream_analytics_complete_response%20%3E%20(schema)>)
class LivestreamGetLivestreamAnalyticsDaywiseResponse: …
data: Optional\[List\[Data]] count: Optional\[int] Count of total livestream sessions. Link to this property date: Optional\[str] Analytics date. Link to this property total\_ingest\_seconds: Optional\[int] Total time duration for which the input was given or the meeting was streamed. Link to this property total\_viewer\_seconds: Optional\[int] Total view time for which the viewers watched the stream. Link to this property
Link to this property success: Optional\[bool] Link to this property
[Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(model)%20livestream_get_livestream_analytics_daywise_response%20%3E%20(schema)>)
class LivestreamGetOrgAnalyticsResponse: …
data: Optional\[Data]
recording\_stats: Optional\[DataRecordingStats] Recording statistics of an App during the range specified
day\_stats: Optional\[List\[DataRecordingStatsDayStat]] Day wise recording stats day: Optional\[str] Link to this property total\_recording\_minutes: Optional\[int] Total recording minutes for a specific day Link to this property total\_recordings: Optional\[int] Total number of recordings for a specific day Link to this property
Link to this property recording\_count: Optional\[int] Total number of recordings during the range specified Link to this property recording\_minutes\_consumed: Optional\[float] Total recording minutes during the range specified Link to this property
Link to this property
session\_stats: Optional\[DataSessionStats] Session statistics of an App during the range specified
day\_stats: Optional\[List\[DataSessionStatsDayStat]] Day wise session stats day: Optional\[str] Link to this property total\_session\_minutes: Optional\[float] Total session minutes for a specific day Link to this property total\_sessions: Optional\[int] Total number of sessions for a specific day Link to this property
Link to this property sessions\_count: Optional\[int] Total number of sessions during the range specified Link to this property sessions\_minutes\_consumed: Optional\[float] Total session minutes during the range specified 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.livestreams%20%3E%20(model)%20livestream_get_org_analytics_response%20%3E%20(schema)>)
class LivestreamGetMeetingActiveLivestreamsResponse: …
data: Optional\[Data] id: Optional\[str] The livestream ID. Link to this property created\_at: Optional\[datetime] Timestamp the object was created at. The time is returned in ISO format. formatdate-time Link to this property disabled: Optional\[str] Specifies if the livestream was disabled. Link to this property ingest\_server: Optional\[str] The server URL to which the RTMP encoder sends the video and audio data. Link to this property meeting\_id: Optional\[str] Link to this property name: Optional\[str] Name of the livestream. Link to this property playback\_url: Optional\[str] The web address that viewers can use to watch the livestream. Link to this property
status: Optional\[Literal\["LIVE", "IDLE", "ERRORED", "INVOKED"]] One of the following: "LIVE" Link to this property "IDLE" Link to this property "ERRORED" Link to this property "INVOKED" Link to this property
Link to this property stream\_key: Optional\[str] Unique key for accessing each livestream. Link to this property updated\_at: Optional\[datetime] Timestamp the object was updated at. The time is returned in ISO format. formatdate-time Link to this property
Link to this property success: Optional\[bool] Link to this property
[Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(model)%20livestream_get_meeting_active_livestreams_response%20%3E%20(schema)>)
class LivestreamGetLivestreamSessionDetailsForSessionIDResponse: …
data: Optional\[Data] id: Optional\[str] The livestream ID. Link to this property created\_at: Optional\[datetime] Timestamp the object was created at. The time is returned in ISO format. formatdate-time Link to this property err\_message: Optional\[str] The server URL to which the RTMP encoder sends the video and audio data. Link to this property ingest\_seconds: Optional\[int] Name of the livestream. Link to this property livestream\_id: Optional\[str] Link to this property started\_time: Optional\[str] Unique key for accessing each livestream. Link to this property stopped\_time: Optional\[str] The web address that viewers can use to watch the livestream. Link to this property updated\_at: Optional\[str] Timestamp the object was updated at. The time is returned in ISO format. Link to this property viewer\_seconds: Optional\[int] Specifies if the livestream was disabled. Link to this property
Link to this property success: Optional\[bool] Link to this property
[Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(model)%20livestream_get_livestream_session_details_for_session_id_response%20%3E%20(schema)>)
class LivestreamGetActiveLivestreamsForLivestreamIDResponse: …
data: Optional\[Data]
livestream: Optional\[DataLivestream] id: Optional\[str] Link to this property created\_at: Optional\[datetime] Timestamp the object was created at. The time is returned in ISO format. formatdate-time Link to this property disabled: Optional\[str] Specifies if the livestream was disabled. Link to this property ingest\_server: Optional\[str] The server URL to which the RTMP encoder sends the video and audio data. Link to this property meeting\_id: Optional\[str] ID of the meeting. Link to this property name: Optional\[str] Name of the livestream. Link to this property playback\_url: Optional\[str] The web address that viewers can use to watch the livestream. Link to this property
status: Optional\[Literal\["LIVE", "IDLE", "ERRORED", "INVOKED"]] One of the following: "LIVE" Link to this property "IDLE" Link to this property "ERRORED" Link to this property "INVOKED" Link to this property
Link to this property stream\_key: Optional\[str] Unique key for accessing each livestream. Link to this property updated\_at: Optional\[datetime] Timestamp the object was updated at. The time is returned in ISO format. formatdate-time Link to this property
Link to this property
session: Optional\[DataSession] id: Optional\[str] Link to this property created\_at: Optional\[datetime] Timestamp the object was created at. The time is returned in ISO format. formatdate-time Link to this property err\_message: Optional\[str] Link to this property ingest\_seconds: Optional\[str] The time duration for which the input was given or the meeting was streamed. Link to this property invoked\_time: Optional\[datetime] Timestamp the object was invoked. The time is returned in ISO format. formatdate-time Link to this property livestream\_id: Optional\[str] Link to this property started\_time: Optional\[datetime] Timestamp the object was started. The time is returned in ISO format. formatdate-time Link to this property stopped\_time: Optional\[datetime] Timestamp the object was stopped. The time is returned in ISO format. formatdate-time Link to this property updated\_at: Optional\[datetime] Timestamp the object was updated at. The time is returned in ISO format. formatdate-time Link to this property viewer\_seconds: Optional\[str] The total view time for which the viewers watched the stream. 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.livestreams%20%3E%20(model)%20livestream_get_active_livestreams_for_livestream_id_response%20%3E%20(schema)>)
class LivestreamGetLivestreamSessionForLivestreamIDResponse: …
data: Optional\[Data]
livestream: Optional\[DataLivestream] id: Optional\[str] ID of the livestream. Link to this property created\_at: Optional\[str] Timestamp the object was created at. The time is returned in ISO format. Link to this property disabled: Optional\[str] Specifies if the livestream was disabled. Link to this property ingest\_server: Optional\[str] The server URL to which the RTMP encoder sends the video and audio data. Link to this property meeting\_id: Optional\[str] The ID of the meeting. Link to this property name: Optional\[str] Name of the livestream. Link to this property playback\_url: Optional\[str] The web address that viewers can use to watch the livestream. Link to this property
status: Optional\[Literal\["LIVE", "IDLE", "ERRORED", "INVOKED"]] One of the following: "LIVE" Link to this property "IDLE" Link to this property "ERRORED" Link to this property "INVOKED" Link to this property
Link to this property stream\_key: Optional\[str] Unique key for accessing each livestream. Link to this property updated\_at: Optional\[str] Timestamp the object was updated at. The time is returned in ISO format. Link to this property
Link to this property
paging: Optional\[DataPaging] end\_offset: Optional\[int] Link to this property start\_offset: Optional\[int] Link to this property total\_count: Optional\[int] Link to this property
Link to this property
session: Optional\[DataSession] id: Optional\[str] ID of the session. Link to this property created\_at: Optional\[datetime] Timestamp the object was created at. The time is returned in ISO format. formatdate-time Link to this property err\_message: Optional\[str] Link to this property ingest\_seconds: Optional\[float] The time duration for which the input was given or the meeting was streamed. Link to this property invoked\_time: Optional\[datetime] Timestamp the object was invoked. The time is returned in ISO format. formatdate-time Link to this property livestream\_id: Optional\[str] Link to this property started\_time: Optional\[datetime] Timestamp the object was started. The time is returned in ISO format. formatdate-time Link to this property stopped\_time: Optional\[datetime] Timestamp the object was stopped. The time is returned in ISO format. formatdate-time Link to this property updated\_at: Optional\[datetime] Timestamp the object was updated at. The time is returned in ISO format. formatdate-time Link to this property viewer\_seconds: Optional\[float] The total view time for which the viewers watched the stream. 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.livestreams%20%3E%20(model)%20livestream_get_livestream_session_for_livestream_id_response%20%3E%20(schema)>)