--- title: Livestreams --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Realtime Kit](https://developers.cloudflare.com/api/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/resources/realtime_kit/subresources/livestreams/methods/get_all_livestreams) GET/accounts/{account\_id}/realtime/kit/{app\_id}/livestreams ##### [Stop livestreaming a meeting](https://developers.cloudflare.com/api/resources/realtime_kit/subresources/livestreams/methods/stop_livestreaming_a_meeting) POST/accounts/{account\_id}/realtime/kit/{app\_id}/meetings/{meeting\_id}/active-livestream/stop ##### [Start livestreaming a meeting](https://developers.cloudflare.com/api/resources/realtime_kit/subresources/livestreams/methods/start_livestreaming_a_meeting) POST/accounts/{account\_id}/realtime/kit/{app\_id}/meetings/{meeting\_id}/livestreams ##### [Fetch complete analytics data for your livestreams](https://developers.cloudflare.com/api/resources/realtime_kit/subresources/livestreams/methods/get_livestream_analytics_complete) GET/accounts/{account\_id}/realtime/kit/{app\_id}/analytics/livestreams/overall ##### [Fetch day-wise analytics data for your livestreams](https://developers.cloudflare.com/api/resources/realtime_kit/subresources/livestreams/methods/get_livestream_analytics_daywise) 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/resources/realtime_kit/subresources/livestreams/methods/get_org_analytics) GET/accounts/{account\_id}/realtime/kit/{app\_id}/analytics/daywise ##### [Fetch active livestreams for a meeting](https://developers.cloudflare.com/api/resources/realtime_kit/subresources/livestreams/methods/get_meeting_active_livestreams) 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/resources/realtime_kit/subresources/livestreams/methods/get_livestream_session_details_for_session_id) GET/accounts/{account\_id}/realtime/kit/{app\_id}/livestreams/sessions/{livestream-session-id} ##### [Fetch active livestream session details](https://developers.cloudflare.com/api/resources/realtime_kit/subresources/livestreams/methods/get_active_livestreams_for_livestream_id) 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/resources/realtime_kit/subresources/livestreams/methods/get_livestream_session_for_livestream_id) GET/accounts/{account\_id}/realtime/kit/{app\_id}/livestreams/{livestream\_id} ##### ModelsExpand Collapse

LivestreamGetAllLivestreamsResponse object {data, success }

data: optional object {id, created\_at, disabled, 8 more }

id: optional string The ID of the livestream. formatuuid Link to this property created\_at: optional string Timestamp the object was created at. The time is returned in ISO format. formatdate-time Link to this property disabled: optional string Specifies if the livestream was disabled. Link to this property ingest\_server: optional string The server URL to which the RTMP encoder sends the video and audio data. Link to this property meeting\_id: optional string ID of the meeting. Link to this property name: optional string Name of the livestream. Link to this property

paging: optional object {end\_offset, start\_offset, total\_count }

end\_offset: optional number Link to this property start\_offset: optional number Link to this property total\_count: optional number Link to this property

Link to this property playback\_url: optional string The web address that viewers can use to watch the livestream. Link to this property

status: optional "LIVE"or "IDLE"or "ERRORED"or "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 string Unique key for accessing each livestream. Link to this property updated\_at: optional string 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 boolean 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)>)

LivestreamStopLivestreamingAMeetingResponse object {data, success }

data: optional object {message }

message: optional string Link to this property

Link to this property success: optional boolean 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)>)

LivestreamStartLivestreamingAMeetingResponse object {data, success }

data: optional object {id, ingest\_server, playback\_url, 2 more }

id: optional string The livestream ID. Link to this property ingest\_server: optional string The server URL to which the RTMP encoder sends the video and audio data. Link to this property playback\_url: optional string The web address that viewers can use to watch the livestream. Link to this property

status: optional "LIVE"or "IDLE"or "ERRORED"or "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 string Unique key for accessing each livestream. Link to this property

Link to this property success: optional boolean 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)>)

LivestreamGetLivestreamAnalyticsCompleteResponse object {data, success }

data: optional object {count, total\_ingest\_seconds, total\_viewer\_seconds }

count: optional number Count of total livestreams. Link to this property total\_ingest\_seconds: optional number Total time duration for which the input was given or the meeting was streamed. Link to this property total\_viewer\_seconds: optional number Total view time for which the viewers watched the stream. Link to this property

Link to this property success: optional boolean 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)>)

LivestreamGetLivestreamAnalyticsDaywiseResponse object {data, success }

data: optional array of object {count, date, total\_ingest\_seconds, total\_viewer\_seconds }

count: optional number Count of total livestream sessions. Link to this property date: optional string Analytics date. Link to this property total\_ingest\_seconds: optional number Total time duration for which the input was given or the meeting was streamed. Link to this property total\_viewer\_seconds: optional number Total view time for which the viewers watched the stream. Link to this property

Link to this property success: optional boolean 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)>)

LivestreamGetOrgAnalyticsResponse object {data, success }

data: optional object {recording\_stats, session\_stats }

recording\_stats: optional object {day\_stats, recording\_count, recording\_minutes\_consumed } Recording statistics of an App during the range specified

day\_stats: optional array of object {day, total\_recording\_minutes, total\_recordings } Day wise recording stats

day: optional string Link to this property total\_recording\_minutes: optional number Total recording minutes for a specific day Link to this property total\_recordings: optional number Total number of recordings for a specific day Link to this property

Link to this property recording\_count: optional number Total number of recordings during the range specified Link to this property recording\_minutes\_consumed: optional number Total recording minutes during the range specified Link to this property

Link to this property

session\_stats: optional object {day\_stats, sessions\_count, sessions\_minutes\_consumed } Session statistics of an App during the range specified

day\_stats: optional array of object {day, total\_session\_minutes, total\_sessions } Day wise session stats

day: optional string Link to this property total\_session\_minutes: optional number Total session minutes for a specific day Link to this property total\_sessions: optional number Total number of sessions for a specific day Link to this property

Link to this property sessions\_count: optional number Total number of sessions during the range specified Link to this property sessions\_minutes\_consumed: optional number Total session minutes during the range specified Link to this property

Link to this property

Link to this property success: optional boolean 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)>)

LivestreamGetMeetingActiveLivestreamsResponse object {data, success }

data: optional object {id, created\_at, disabled, 7 more }

id: optional string The livestream ID. Link to this property created\_at: optional string Timestamp the object was created at. The time is returned in ISO format. formatdate-time Link to this property disabled: optional string Specifies if the livestream was disabled. Link to this property ingest\_server: optional string The server URL to which the RTMP encoder sends the video and audio data. Link to this property meeting\_id: optional string Link to this property name: optional string Name of the livestream. Link to this property playback\_url: optional string The web address that viewers can use to watch the livestream. Link to this property

status: optional "LIVE"or "IDLE"or "ERRORED"or "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 success: optional boolean 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)>)

LivestreamGetLivestreamSessionDetailsForSessionIDResponse object {data, success }

data: optional object {id, created\_at, err\_message, 6 more }

id: optional string The livestream ID. Link to this property created\_at: optional string Timestamp the object was created at. The time is returned in ISO format. formatdate-time Link to this property err\_message: optional string The server URL to which the RTMP encoder sends the video and audio data. Link to this property ingest\_seconds: optional number Name of the livestream. Link to this property livestream\_id: optional string Link to this property started\_time: optional string Unique key for accessing each livestream. Link to this property stopped\_time: optional string The web address that viewers can use to watch the livestream. Link to this property updated\_at: optional string Timestamp the object was updated at. The time is returned in ISO format. Link to this property viewer\_seconds: optional number Specifies if the livestream was disabled. Link to this property

Link to this property success: optional boolean 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)>)

LivestreamGetActiveLivestreamsForLivestreamIDResponse object {data, success }

data: optional object {livestream, session }

livestream: optional object {id, created\_at, disabled, 7 more }

id: optional string Link to this property created\_at: optional string Timestamp the object was created at. The time is returned in ISO format. formatdate-time Link to this property disabled: optional string Specifies if the livestream was disabled. Link to this property ingest\_server: optional string The server URL to which the RTMP encoder sends the video and audio data. Link to this property meeting\_id: optional string ID of the meeting. Link to this property name: optional string Name of the livestream. Link to this property playback\_url: optional string The web address that viewers can use to watch the livestream. Link to this property

status: optional "LIVE"or "IDLE"or "ERRORED"or "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

session: optional object {id, created\_at, err\_message, 7 more }

id: optional string Link to this property created\_at: optional string Timestamp the object was created at. The time is returned in ISO format. formatdate-time Link to this property err\_message: optional string Link to this property ingest\_seconds: optional string The time duration for which the input was given or the meeting was streamed. Link to this property invoked\_time: optional string Timestamp the object was invoked. The time is returned in ISO format. formatdate-time Link to this property livestream\_id: optional string Link to this property started\_time: optional string Timestamp the object was started. The time is returned in ISO format. formatdate-time Link to this property stopped\_time: optional string Timestamp the object was stopped. The time is returned in ISO format. formatdate-time Link to this property updated\_at: optional string Timestamp the object was updated at. The time is returned in ISO format. formatdate-time Link to this property viewer\_seconds: optional string 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 boolean 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)>)

LivestreamGetLivestreamSessionForLivestreamIDResponse object {data, success }

data: optional object {livestream, paging, session }

livestream: optional object {id, created\_at, disabled, 7 more }

id: optional string ID of the livestream. Link to this property created\_at: optional string Timestamp the object was created at. The time is returned in ISO format. Link to this property disabled: optional string Specifies if the livestream was disabled. Link to this property ingest\_server: optional string The server URL to which the RTMP encoder sends the video and audio data. Link to this property meeting\_id: optional string The ID of the meeting. Link to this property name: optional string Name of the livestream. Link to this property playback\_url: optional string The web address that viewers can use to watch the livestream. Link to this property

status: optional "LIVE"or "IDLE"or "ERRORED"or "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

paging: optional object {end\_offset, start\_offset, total\_count }

end\_offset: optional number Link to this property start\_offset: optional number Link to this property total\_count: optional number Link to this property

Link to this property

session: optional object {id, created\_at, err\_message, 7 more }

id: optional string ID of the session. Link to this property created\_at: optional string Timestamp the object was created at. The time is returned in ISO format. formatdate-time Link to this property err\_message: optional string Link to this property ingest\_seconds: optional number The time duration for which the input was given or the meeting was streamed. Link to this property invoked\_time: optional string Timestamp the object was invoked. The time is returned in ISO format. formatdate-time Link to this property livestream\_id: optional string Link to this property started\_time: optional string Timestamp the object was started. The time is returned in ISO format. formatdate-time Link to this property stopped\_time: optional string Timestamp the object was stopped. The time is returned in ISO format. formatdate-time Link to this property updated\_at: optional string Timestamp the object was updated at. The time is returned in ISO format. formatdate-time Link to this property viewer\_seconds: optional number 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 boolean 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)>)