--- title: Fetch all livestreams --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Realtime Kit](https://developers.cloudflare.com/api/go/resources/realtime_kit) [Livestreams](https://developers.cloudflare.com/api/go/resources/realtime_kit/subresources/livestreams) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Fetch all livestreams client.RealtimeKit.Livestreams.GetAllLivestreams(ctx, appID, params) (\*[LivestreamGetAllLivestreamsResponse](), error) GET/accounts/{account\_id}/realtime/kit/{app\_id}/livestreams Returns details of livestreams associated with the given App ID. It includes livestreams created by your App and RealtimeKit meetings that are livestreamed by your App. If you only want details of livestreams created by your App and not RealtimeKit meetings, you can use the `exclude_meetings` query parameter. ##### 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 appID string The app identifier tag. [Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(method)%20get_all_livestreams%20%3E%20(params)%20default%20%3E%20(param)%20app_id%20%3E%20(schema)>)
params LivestreamGetAllLivestreamsParams AccountID param.Field\[string] Path param: The account identifier tag. maxLength32 Link to this property EndTime param.Field\[Time]Optional Query param: Specify the end time range in ISO format to access the live stream. formatdate-time Link to this property ExcludeMeetings param.Field\[bool]Optional Query param: Exclude the RealtimeKit meetings that are livestreamed. Link to this property PageNo param.Field\[int64]Optional Query param: The page number from which you want your page search results to be displayed. Link to this property PerPage param.Field\[int64]Optional Query param: Number of results per page. Link to this property
SortOrder param.Field\[LivestreamGetAllLivestreamsParamsSortOrder]Optional Query param: Specifies the sorting order for the results. const LivestreamGetAllLivestreamsParamsSortOrderAsc LivestreamGetAllLivestreamsParamsSortOrder = "ASC" Link to this property const LivestreamGetAllLivestreamsParamsSortOrderDsc LivestreamGetAllLivestreamsParamsSortOrder = "DSC" Link to this property
Link to this property StartTime param.Field\[Time]Optional Query param: Specify the start time range in ISO format to access the live stream. formatdate-time Link to this property
Status param.Field\[LivestreamGetAllLivestreamsParamsStatus]Optional Query param: Specifies the status of the operation. const LivestreamGetAllLivestreamsParamsStatusLive LivestreamGetAllLivestreamsParamsStatus = "LIVE" Link to this property const LivestreamGetAllLivestreamsParamsStatusIdle LivestreamGetAllLivestreamsParamsStatus = "IDLE" Link to this property const LivestreamGetAllLivestreamsParamsStatusErrored LivestreamGetAllLivestreamsParamsStatus = "ERRORED" Link to this property const LivestreamGetAllLivestreamsParamsStatusInvoked LivestreamGetAllLivestreamsParamsStatus = "INVOKED" Link to this property
Link to this property
[Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(method)%20get_all_livestreams%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type LivestreamGetAllLivestreamsResponse struct{…}
Data LivestreamGetAllLivestreamsResponseDataOptional ID stringOptional The ID of the livestream. formatuuid Link to this property CreatedAt TimeOptional Timestamp the object was created at. The time is returned in ISO format. formatdate-time Link to this property Disabled stringOptional Specifies if the livestream was disabled. Link to this property IngestServer stringOptional The server URL to which the RTMP encoder sends the video and audio data. Link to this property MeetingID stringOptional ID of the meeting. Link to this property Name stringOptional Name of the livestream. Link to this property
Paging LivestreamGetAllLivestreamsResponseDataPagingOptional EndOffset int64Optional Link to this property StartOffset int64Optional Link to this property TotalCount int64Optional Link to this property
Link to this property PlaybackURL stringOptional The web address that viewers can use to watch the livestream. Link to this property
Status LivestreamGetAllLivestreamsResponseDataStatusOptional One of the following: const LivestreamGetAllLivestreamsResponseDataStatusLive LivestreamGetAllLivestreamsResponseDataStatus = "LIVE" Link to this property const LivestreamGetAllLivestreamsResponseDataStatusIdle LivestreamGetAllLivestreamsResponseDataStatus = "IDLE" Link to this property const LivestreamGetAllLivestreamsResponseDataStatusErrored LivestreamGetAllLivestreamsResponseDataStatus = "ERRORED" Link to this property const LivestreamGetAllLivestreamsResponseDataStatusInvoked LivestreamGetAllLivestreamsResponseDataStatus = "INVOKED" Link to this property
Link to this property StreamKey stringOptional Unique key for accessing each livestream. Link to this property UpdatedAt TimeOptional Timestamp the object was updated at. The time is returned in ISO format. formatdate-time Link to this property
Link to this property Success boolOptional Link to this property
[Link to this property](<#(resource)%20realtime_kit.livestreams%20%3E%20(model)%20LivestreamGetAllLivestreamsResponse%20%3E%20(schema)>) ### Fetch all livestreams Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/realtime_kit" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) response, err := client.RealtimeKit.Livestreams.GetAllLivestreams( context.TODO(), "14a396e7-ca44-4937-bf1f-050a69118543", realtime_kit.LivestreamGetAllLivestreamsParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", response.Data) } ``` 200 example ``` { "data": { "id": "3fd739f4-3c41-456e-bfba-6ebd51e16d2d", "created_at": "2023-07-15T11:48:34.753Z", "disabled": "disabled", "ingest_server": "rtmps://live.cloudflare.com:443/live/", "meeting_id": "meeting_id", "name": "test", "paging": { "end_offset": 1, "start_offset": 1, "total_count": 1 }, "playback_url": "https://customer-s8oj0c1n5ek8ah1e.cloudflarestream.com/7de6a3fec0f9c05bf1df140950d3a237/manifest/video.m3u8", "status": "LIVE", "stream_key": "f26566285faca6fbe2e79a73a66rsrrsrrsr3cde23a2bb7dbc6c2c1761b98f4e4", "updated_at": "2023-07-15T11:48:34.753Z" }, "success": true } ``` ##### Returns Examples 200 example ``` { "data": { "id": "3fd739f4-3c41-456e-bfba-6ebd51e16d2d", "created_at": "2023-07-15T11:48:34.753Z", "disabled": "disabled", "ingest_server": "rtmps://live.cloudflare.com:443/live/", "meeting_id": "meeting_id", "name": "test", "paging": { "end_offset": 1, "start_offset": 1, "total_count": 1 }, "playback_url": "https://customer-s8oj0c1n5ek8ah1e.cloudflarestream.com/7de6a3fec0f9c05bf1df140950d3a237/manifest/video.m3u8", "status": "LIVE", "stream_key": "f26566285faca6fbe2e79a73a66rsrrsrrsr3cde23a2bb7dbc6c2c1761b98f4e4", "updated_at": "2023-07-15T11:48:34.753Z" }, "success": true } ```