--- title: Fetch all meetings for 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) [Meetings](https://developers.cloudflare.com/api/go/resources/realtime_kit/subresources/meetings) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Fetch all meetings for an App client.RealtimeKit.Meetings.Get(ctx, appID, params) (\*[MeetingGetResponse](), error) GET/accounts/{account\_id}/realtime/kit/{app\_id}/meetings Returns all meetings for the given App ID. ##### 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.meetings%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20app_id%20%3E%20(schema)>)

params MeetingGetParams

AccountID param.Field\[string] Path param: The account identifier tag. maxLength32 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 PerPage param.Field\[float64]Optional Query param: Number of results per page minimum0 Link to this property Search param.Field\[string]Optional Query param: The search query string. You can search using the meeting ID or title. 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\[MeetingGetParamsStatus]Optional Query param: Filter meetings by status.

const MeetingGetParamsStatusActive MeetingGetParamsStatus = "ACTIVE" Link to this property const MeetingGetParamsStatusInactive MeetingGetParamsStatus = "INACTIVE" Link to this property

Link to this property

[Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(method)%20get%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse

type MeetingGetResponse struct{…}

Data \[]MeetingGetResponseData

ID string ID of the meeting. formatuuid Link to this property CreatedAt Time Timestamp the object was created at. The time is returned in ISO format. formatdate-time Link to this property UpdatedAt Time Timestamp the object was updated at. The time is returned in ISO format. formatdate-time Link to this property LiveStreamOnStart boolOptional Specifies if the meeting should start getting livestreamed on start. Link to this property PersistChat boolOptional Specifies if Chat within a meeting should persist for a week. Link to this property RecordOnStart boolOptional Specifies if the meeting should start getting recorded as soon as someone joins the meeting. Link to this property

RecordingConfig MeetingGetResponseDataRecordingConfigOptional Recording Configurations to be used for this meeting. This level of configs takes higher preference over App level configs on the RealtimeKit developer portal.

AudioConfig MeetingGetResponseDataRecordingConfigAudioConfigOptional Object containing configuration regarding the audio that is being recorded.

Channel MeetingGetResponseDataRecordingConfigAudioConfigChannelOptional Audio signal pathway within an audio file that carries a specific sound source.

One of the following: const MeetingGetResponseDataRecordingConfigAudioConfigChannelMono MeetingGetResponseDataRecordingConfigAudioConfigChannel = "mono" Link to this property const MeetingGetResponseDataRecordingConfigAudioConfigChannelStereo MeetingGetResponseDataRecordingConfigAudioConfigChannel = "stereo" Link to this property

Link to this property

Codec MeetingGetResponseDataRecordingConfigAudioConfigCodecOptional Codec using which the recording will be encoded. If VP8/VP9 is selected for videoConfig, changing audioConfig is not allowed. In this case, the codec in the audioConfig is automatically set to vorbis.

One of the following: const MeetingGetResponseDataRecordingConfigAudioConfigCodecMP3 MeetingGetResponseDataRecordingConfigAudioConfigCodec = "MP3" Link to this property const MeetingGetResponseDataRecordingConfigAudioConfigCodecAac MeetingGetResponseDataRecordingConfigAudioConfigCodec = "AAC" Link to this property

Link to this property ExportFile boolOptional Controls whether to export audio file seperately Link to this property

Link to this property FileNamePrefix stringOptional Adds a prefix to the beginning of the file name of the recording. Link to this property

LiveStreamingConfig MeetingGetResponseDataRecordingConfigLiveStreamingConfigOptional

RtmpURL stringOptional RTMP URL to stream to formaturi Link to this property

Link to this property MaxSeconds float64Optional Specifies the maximum duration for recording in seconds, ranging from a minimum of 60 seconds to a maximum of 24 hours. maximum86400 minimum60 Link to this property

RealtimekitBucketConfig MeetingGetResponseDataRecordingConfigRealtimekitBucketConfigOptional

Enabled bool Controls whether recordings are uploaded to RealtimeKit’s bucket. If set to false, download_url, audio_download_url, download_url_expiry won’t be generated for a recording. Link to this property

Link to this property

StorageConfig MeetingGetResponseDataRecordingConfigStorageConfigOptional

One of the following:

type MeetingGetResponseDataRecordingConfigStorageConfigObject struct{…}

AccessKey stringOptional Access key of the storage medium. Access key is not required for the gcs storage media type. Note that this field is not readable by clients, only writeable. Link to this property

AuthMethod MeetingGetResponseDataRecordingConfigStorageConfigObjectAuthMethodOptional Authentication method used for “sftp” type storage medium

One of the following: const MeetingGetResponseDataRecordingConfigStorageConfigObjectAuthMethodKey MeetingGetResponseDataRecordingConfigStorageConfigObjectAuthMethod = "KEY" Link to this property const MeetingGetResponseDataRecordingConfigStorageConfigObjectAuthMethodPassword MeetingGetResponseDataRecordingConfigStorageConfigObjectAuthMethod = "PASSWORD" Link to this property

Link to this property Bucket stringOptional Name of the storage medium’s bucket. Link to this property Host stringOptional SSH destination server host for SFTP type storage medium Link to this property Password stringOptional SSH destination server password for SFTP type storage medium when auth\_method is “PASSWORD”. If auth\_method is “KEY”, this specifies the password for the ssh private key. Link to this property Path stringOptional Path relative to the bucket root at which the recording will be placed. Link to this property Port float64Optional SSH destination server port for SFTP type storage medium Link to this property PrivateKey stringOptional Private key used to login to destination SSH server for SFTP type storage medium, when auth\_method used is “KEY” Link to this property Region stringOptional Region of the storage medium. Link to this property Secret stringOptional Secret key of the storage medium. Similar to access_key, it is only writeable by clients, not readable. Link to this property Type MeetingGetResponseDataRecordingConfigStorageConfigObjectTypeOptional Link to this property Username stringOptional SSH destination server username for SFTP type storage medium Link to this property

Link to this property

type MeetingGetResponseDataRecordingConfigStorageConfigObject struct{…}

AccessKey unknown minLength1 Link to this property Region unknown minLength1 Link to this property

AuthMethod MeetingGetResponseDataRecordingConfigStorageConfigObjectAuthMethodOptional Authentication method used for “sftp” type storage medium

Link to this property Bucket stringOptional Name of the storage medium’s bucket. Link to this property Host stringOptional SSH destination server host for SFTP type storage medium Link to this property Password stringOptional SSH destination server password for SFTP type storage medium when auth\_method is “PASSWORD”. If auth\_method is “KEY”, this specifies the password for the ssh private key. Link to this property Path stringOptional Path relative to the bucket root at which the recording will be placed. Link to this property Port float64Optional SSH destination server port for SFTP type storage medium Link to this property PrivateKey stringOptional Private key used to login to destination SSH server for SFTP type storage medium, when auth\_method used is “KEY” Link to this property Secret stringOptional Secret key of the storage medium. Similar to access_key, it is only writeable by clients, not readable. Link to this property

Type MeetingGetResponseDataRecordingConfigStorageConfigObjectTypeOptional

Link to this property Username stringOptional SSH destination server username for SFTP type storage medium Link to this property

Link to this property

type MeetingGetResponseDataRecordingConfigStorageConfigObject struct{…}

PrivateKey string Private key used to login to destination SSH server for SFTP type storage medium, when auth\_method used is “KEY” Link to this property AccessKey stringOptional Access key of the storage medium. Access key is not required for the gcs storage media type. Note that this field is not readable by clients, only writeable. Link to this property AuthMethod MeetingGetResponseDataRecordingConfigStorageConfigObjectAuthMethodOptional Link to this property Bucket stringOptional Name of the storage medium’s bucket. Link to this property Host stringOptional SSH destination server host for SFTP type storage medium Link to this property Password stringOptional SSH destination server password for SFTP type storage medium when auth\_method is “PASSWORD”. If auth\_method is “KEY”, this specifies the password for the ssh private key. Link to this property Path stringOptional Path relative to the bucket root at which the recording will be placed. Link to this property Port float64Optional SSH destination server port for SFTP type storage medium Link to this property Region stringOptional Region of the storage medium. Link to this property Secret stringOptional Secret key of the storage medium. Similar to access_key, it is only writeable by clients, not readable. Link to this property

Type MeetingGetResponseDataRecordingConfigStorageConfigObjectTypeOptional Type of storage media.

One of the following: const MeetingGetResponseDataRecordingConfigStorageConfigObjectTypeAws MeetingGetResponseDataRecordingConfigStorageConfigObjectType = "aws" Link to this property const MeetingGetResponseDataRecordingConfigStorageConfigObjectTypeAzure MeetingGetResponseDataRecordingConfigStorageConfigObjectType = "azure" Link to this property const MeetingGetResponseDataRecordingConfigStorageConfigObjectTypeDigitalocean MeetingGetResponseDataRecordingConfigStorageConfigObjectType = "digitalocean" Link to this property const MeetingGetResponseDataRecordingConfigStorageConfigObjectTypeGcs MeetingGetResponseDataRecordingConfigStorageConfigObjectType = "gcs" Link to this property const MeetingGetResponseDataRecordingConfigStorageConfigObjectTypeSftp MeetingGetResponseDataRecordingConfigStorageConfigObjectType = "sftp" Link to this property

Link to this property Username stringOptional SSH destination server username for SFTP type storage medium Link to this property

Link to this property

type MeetingGetResponseDataRecordingConfigStorageConfigObject struct{…}

Password string SSH destination server password for SFTP type storage medium when auth\_method is “PASSWORD”. If auth\_method is “KEY”, this specifies the password for the ssh private key. Link to this property AccessKey stringOptional Access key of the storage medium. Access key is not required for the gcs storage media type. Note that this field is not readable by clients, only writeable. Link to this property AuthMethod MeetingGetResponseDataRecordingConfigStorageConfigObjectAuthMethodOptional Link to this property Bucket stringOptional Name of the storage medium’s bucket. Link to this property Host stringOptional SSH destination server host for SFTP type storage medium Link to this property Path stringOptional Path relative to the bucket root at which the recording will be placed. Link to this property Port float64Optional SSH destination server port for SFTP type storage medium Link to this property PrivateKey stringOptional Private key used to login to destination SSH server for SFTP type storage medium, when auth\_method used is “KEY” Link to this property Region stringOptional Region of the storage medium. Link to this property Secret stringOptional Secret key of the storage medium. Similar to access_key, it is only writeable by clients, not readable. Link to this property

Type MeetingGetResponseDataRecordingConfigStorageConfigObjectTypeOptional Type of storage media.

Link to this property Username stringOptional SSH destination server username for SFTP type storage medium Link to this property

Link to this property

VideoConfig MeetingGetResponseDataRecordingConfigVideoConfigOptional

Codec MeetingGetResponseDataRecordingConfigVideoConfigCodecOptional Codec using which the recording will be encoded.

One of the following: const MeetingGetResponseDataRecordingConfigVideoConfigCodecH264 MeetingGetResponseDataRecordingConfigVideoConfigCodec = "H264" Link to this property const MeetingGetResponseDataRecordingConfigVideoConfigCodecVp8 MeetingGetResponseDataRecordingConfigVideoConfigCodec = "VP8" Link to this property const MeetingGetResponseDataRecordingConfigVideoConfigCodecVp9 MeetingGetResponseDataRecordingConfigVideoConfigCodec = "VP9" Link to this property

Link to this property ExportFile boolOptional Controls whether to export video file seperately Link to this property Height int64Optional Height of the recording video in pixels maximum1920 minimum1 Link to this property

Watermark MeetingGetResponseDataRecordingConfigVideoConfigWatermarkOptional Watermark to be added to the recording

Position MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPositionOptional Position of the watermark

One of the following: const MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPositionLeftTop MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPosition = "left top" Link to this property const MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPositionRightTop MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPosition = "right top" Link to this property const MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPositionLeftBottom MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPosition = "left bottom" Link to this property const MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPositionRightBottom MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPosition = "right bottom" Link to this property

Link to this property

Size MeetingGetResponseDataRecordingConfigVideoConfigWatermarkSizeOptional Size of the watermark

Height int64Optional Height of the watermark in px minimum1 Link to this property Width int64Optional Width of the watermark in px minimum1 Link to this property

Link to this property URL stringOptional URL of the watermark image formaturi Link to this property

Link to this property Width int64Optional Width of the recording video in pixels maximum1920 minimum1 Link to this property

Link to this property

Link to this property SessionKeepAliveTimeInSecs float64Optional Time in seconds, for which a session remains active, after the last participant has left the meeting. maximum600 minimum60 Link to this property

Status MeetingGetResponseDataStatusOptional Whether the meeting is ACTIVE or INACTIVE. Users will not be able to join an INACTIVE meeting.

One of the following: const MeetingGetResponseDataStatusActive MeetingGetResponseDataStatus = "ACTIVE" Link to this property const MeetingGetResponseDataStatusInactive MeetingGetResponseDataStatus = "INACTIVE" Link to this property

Link to this property SummarizeOnEnd boolOptional Automatically generate summary of meetings using transcripts. Requires Transcriptions to be enabled, and can be retrieved via Webhooks or summary API. Link to this property Title stringOptional Title of the meeting. Link to this property TranscribeOnEnd boolOptional Automatically generate transcripts when the meeting ends. Link to this property

Link to this property

Paging MeetingGetResponsePaging

EndOffset float64 Link to this property StartOffset float64 Link to this property TotalCount float64 minimum0 Link to this property

Link to this property Success bool Link to this property

[Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(model)%20MeetingGetResponse%20%3E%20(schema)>) ### Fetch all meetings for 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"), ) meeting, err := client.RealtimeKit.Meetings.Get( context.TODO(), "14a396e7-ca44-4937-bf1f-050a69118543", realtime_kit.MeetingGetParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", meeting.Data) } ``` 200 example ``` { "data": [ { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "created_at": "2019-12-27T18:11:19.117Z", "updated_at": "2019-12-27T18:11:19.117Z", "live_stream_on_start": true, "persist_chat": true, "record_on_start": true, "recording_config": { "audio_config": { "channel": "mono", "codec": "MP3", "export_file": true }, "file_name_prefix": "file_name_prefix", "live_streaming_config": { "rtmp_url": "rtmp://a.rtmp.youtube.com/live2" }, "max_seconds": 60, "realtimekit_bucket_config": { "enabled": true }, "storage_config": { "auth_method": "KEY", "bucket": "bucket", "host": "host", "path": "path", "port": 0, "region": "us-east-1", "type": "gcs", "username": "username" }, "video_config": { "codec": "H264", "export_file": true, "height": 720, "watermark": { "position": "left top", "size": { "height": 1, "width": 1 }, "url": "https://example.com" }, "width": 1280 } }, "session_keep_alive_time_in_secs": 60, "status": "ACTIVE", "summarize_on_end": true, "title": "title", "transcribe_on_end": true } ], "paging": { "end_offset": 30, "start_offset": 1, "total_count": 30 }, "success": true } ``` ##### Returns Examples 200 example ``` { "data": [ { "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e", "created_at": "2019-12-27T18:11:19.117Z", "updated_at": "2019-12-27T18:11:19.117Z", "live_stream_on_start": true, "persist_chat": true, "record_on_start": true, "recording_config": { "audio_config": { "channel": "mono", "codec": "MP3", "export_file": true }, "file_name_prefix": "file_name_prefix", "live_streaming_config": { "rtmp_url": "rtmp://a.rtmp.youtube.com/live2" }, "max_seconds": 60, "realtimekit_bucket_config": { "enabled": true }, "storage_config": { "auth_method": "KEY", "bucket": "bucket", "host": "host", "path": "path", "port": 0, "region": "us-east-1", "type": "gcs", "username": "username" }, "video_config": { "codec": "H264", "export_file": true, "height": 720, "watermark": { "position": "left top", "size": { "height": 1, "width": 1 }, "url": "https://example.com" }, "width": 1280 } }, "session_keep_alive_time_in_secs": 60, "status": "ACTIVE", "summarize_on_end": true, "title": "title", "transcribe_on_end": true } ], "paging": { "end_offset": 30, "start_offset": 1, "total_count": 30 }, "success": true } ```