--- title: Fetch all sessions of an App --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Realtime Kit](https://developers.cloudflare.com/api/go/resources/realtime_kit) [Sessions](https://developers.cloudflare.com/api/go/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 client.RealtimeKit.Sessions.GetSessions(ctx, appID, params) (\*[SessionGetSessionsResponse](), error) 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 appID string 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)>)
params SessionGetSessionsParams AccountID param.Field\[string] Path param: The account identifier tag. maxLength32 Link to this property AssociatedID param.Field\[string]Optional Query param: ID of the meeting that sessions should be associated with formatuuid Link to this property EndTime param.Field\[Time]Optional Query param: 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 PageNo param.Field\[float64]Optional Query param: The page number from which you want your page search results to be displayed. minimum0 Link to this property Participants param.Field\[string]Optional Query param Link to this property PerPage param.Field\[float64]Optional Query param: Number of results per page minimum0 Link to this property Search param.Field\[string]Optional Query param: Search string that matches sessions based on meeting title, meeting ID, and session ID Link to this property
SortBy param.Field\[SessionGetSessionsParamsSortBy]Optional Query param const SessionGetSessionsParamsSortByMinutesConsumed SessionGetSessionsParamsSortBy = "minutesConsumed" Link to this property const SessionGetSessionsParamsSortByCreatedAt SessionGetSessionsParamsSortBy = "createdAt" Link to this property
Link to this property
SortOrder param.Field\[SessionGetSessionsParamsSortOrder]Optional Query param const SessionGetSessionsParamsSortOrderAsc SessionGetSessionsParamsSortOrder = "ASC" Link to this property const SessionGetSessionsParamsSortOrderDesc SessionGetSessionsParamsSortOrder = "DESC" Link to this property
Link to this property StartTime param.Field\[Time]Optional Query param: 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
Status param.Field\[SessionGetSessionsParamsStatus]Optional Query param const SessionGetSessionsParamsStatusLive SessionGetSessionsParamsStatus = "LIVE" Link to this property const SessionGetSessionsParamsStatusEnded SessionGetSessionsParamsStatus = "ENDED" Link to this property
Link to this property
[Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(method)%20get_sessions%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type SessionGetSessionsResponse struct{…}
Data SessionGetSessionsResponseDataOptional
Sessions \[]SessionGetSessionsResponseDataSessionOptional ID string ID of the session Link to this property AssociatedID string 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 CreatedAt string timestamp when session created Link to this property LiveParticipants float64 number of participants currently in the session Link to this property MaxConcurrentParticipants float64 number of maximum participants that were in the session Link to this property MeetingDisplayName string Title of the meeting this session belongs to Link to this property MinutesConsumed float64 number of minutes consumed since the session started Link to this property OrganizationID string App id that hosted this session Link to this property StartedAt string timestamp when session started Link to this property
Status SessionGetSessionsResponseDataSessionsStatus current status of session One of the following: const SessionGetSessionsResponseDataSessionsStatusLive SessionGetSessionsResponseDataSessionsStatus = "LIVE" Link to this property const SessionGetSessionsResponseDataSessionsStatusEnded SessionGetSessionsResponseDataSessionsStatus = "ENDED" Link to this property
Link to this property
Type SessionGetSessionsResponseDataSessionsType type of session One of the following: const SessionGetSessionsResponseDataSessionsTypeMeeting SessionGetSessionsResponseDataSessionsType = "meeting" Link to this property const SessionGetSessionsResponseDataSessionsTypeLivestream SessionGetSessionsResponseDataSessionsType = "livestream" Link to this property const SessionGetSessionsResponseDataSessionsTypeParticipant SessionGetSessionsResponseDataSessionsType = "participant" Link to this property
Link to this property UpdatedAt string timestamp when session was last updated Link to this property BreakoutRooms \[]unknownOptional Link to this property EndedAt stringOptional timestamp when session ended Link to this property
Link to this property
Link to this property
Paging SessionGetSessionsResponsePagingOptional EndOffset float64Optional Link to this property StartOffset float64Optional Link to this property TotalCount float64Optional minimum0 Link to this property
Link to this property Success boolOptional Link to this property
[Link to this property](<#(resource)%20realtime_kit.sessions%20%3E%20(model)%20SessionGetSessionsResponse%20%3E%20(schema)>) ### Fetch all sessions of an App 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.Sessions.GetSessions( context.TODO(), "14a396e7-ca44-4937-bf1f-050a69118543", realtime_kit.SessionGetSessionsParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", 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 } ```