## 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. ### Parameters - `appID string` The app identifier tag. - `params MeetingGetParams` - `AccountID param.Field[string]` Path param: The account identifier tag. - `EndTime param.Field[Time]` Query param: The end time range for which you want to retrieve the meetings. The time must be specified in ISO format. - `PageNo param.Field[float64]` Query param: The page number from which you want your page search results to be displayed. - `PerPage param.Field[float64]` Query param: Number of results per page - `Search param.Field[string]` Query param: The search query string. You can search using the meeting ID or title. - `StartTime param.Field[Time]` Query param: The start time range for which you want to retrieve the meetings. The time must be specified in ISO format. - `Status param.Field[MeetingGetParamsStatus]` Query param: Filter meetings by status. - `const MeetingGetParamsStatusActive MeetingGetParamsStatus = "ACTIVE"` - `const MeetingGetParamsStatusInactive MeetingGetParamsStatus = "INACTIVE"` ### Returns - `type MeetingGetResponse struct{…}` - `Data []MeetingGetResponseData` - `ID string` ID of the meeting. - `CreatedAt Time` Timestamp the object was created at. The time is returned in ISO format. - `UpdatedAt Time` Timestamp the object was updated at. The time is returned in ISO format. - `LiveStreamOnStart bool` Specifies if the meeting should start getting livestreamed on start. - `PersistChat bool` Specifies if Chat within a meeting should persist for a week. - `RecordOnStart bool` Specifies if the meeting should start getting recorded as soon as someone joins the meeting. - `RecordingConfig MeetingGetResponseDataRecordingConfig` 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 MeetingGetResponseDataRecordingConfigAudioConfig` Object containing configuration regarding the audio that is being recorded. - `Channel MeetingGetResponseDataRecordingConfigAudioConfigChannel` Audio signal pathway within an audio file that carries a specific sound source. - `const MeetingGetResponseDataRecordingConfigAudioConfigChannelMono MeetingGetResponseDataRecordingConfigAudioConfigChannel = "mono"` - `const MeetingGetResponseDataRecordingConfigAudioConfigChannelStereo MeetingGetResponseDataRecordingConfigAudioConfigChannel = "stereo"` - `Codec MeetingGetResponseDataRecordingConfigAudioConfigCodec` 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. - `const MeetingGetResponseDataRecordingConfigAudioConfigCodecMP3 MeetingGetResponseDataRecordingConfigAudioConfigCodec = "MP3"` - `const MeetingGetResponseDataRecordingConfigAudioConfigCodecAac MeetingGetResponseDataRecordingConfigAudioConfigCodec = "AAC"` - `ExportFile bool` Controls whether to export audio file seperately - `FileNamePrefix string` Adds a prefix to the beginning of the file name of the recording. - `LiveStreamingConfig MeetingGetResponseDataRecordingConfigLiveStreamingConfig` - `RtmpURL string` RTMP URL to stream to - `MaxSeconds float64` Specifies the maximum duration for recording in seconds, ranging from a minimum of 60 seconds to a maximum of 24 hours. - `RealtimekitBucketConfig MeetingGetResponseDataRecordingConfigRealtimekitBucketConfig` - `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. - `StorageConfig MeetingGetResponseDataRecordingConfigStorageConfig` - `Type MeetingGetResponseDataRecordingConfigStorageConfigType` Type of storage media. - `const MeetingGetResponseDataRecordingConfigStorageConfigTypeAws MeetingGetResponseDataRecordingConfigStorageConfigType = "aws"` - `const MeetingGetResponseDataRecordingConfigStorageConfigTypeAzure MeetingGetResponseDataRecordingConfigStorageConfigType = "azure"` - `const MeetingGetResponseDataRecordingConfigStorageConfigTypeDigitalocean MeetingGetResponseDataRecordingConfigStorageConfigType = "digitalocean"` - `const MeetingGetResponseDataRecordingConfigStorageConfigTypeGcs MeetingGetResponseDataRecordingConfigStorageConfigType = "gcs"` - `const MeetingGetResponseDataRecordingConfigStorageConfigTypeSftp MeetingGetResponseDataRecordingConfigStorageConfigType = "sftp"` - `AccessKey string` 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. - `AuthMethod MeetingGetResponseDataRecordingConfigStorageConfigAuthMethod` Authentication method used for "sftp" type storage medium - `const MeetingGetResponseDataRecordingConfigStorageConfigAuthMethodKey MeetingGetResponseDataRecordingConfigStorageConfigAuthMethod = "KEY"` - `const MeetingGetResponseDataRecordingConfigStorageConfigAuthMethodPassword MeetingGetResponseDataRecordingConfigStorageConfigAuthMethod = "PASSWORD"` - `Bucket string` Name of the storage medium's bucket. - `Host string` SSH destination server host for SFTP type storage medium - `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. - `Path string` Path relative to the bucket root at which the recording will be placed. - `Port float64` SSH destination server port for SFTP type storage medium - `PrivateKey string` Private key used to login to destination SSH server for SFTP type storage medium, when auth_method used is "KEY" - `Region string` Region of the storage medium. - `Secret string` Secret key of the storage medium. Similar to `access_key`, it is only writeable by clients, not readable. - `Username string` SSH destination server username for SFTP type storage medium - `VideoConfig MeetingGetResponseDataRecordingConfigVideoConfig` - `Codec MeetingGetResponseDataRecordingConfigVideoConfigCodec` Codec using which the recording will be encoded. - `const MeetingGetResponseDataRecordingConfigVideoConfigCodecH264 MeetingGetResponseDataRecordingConfigVideoConfigCodec = "H264"` - `const MeetingGetResponseDataRecordingConfigVideoConfigCodecVp8 MeetingGetResponseDataRecordingConfigVideoConfigCodec = "VP8"` - `ExportFile bool` Controls whether to export video file seperately - `Height int64` Height of the recording video in pixels - `Watermark MeetingGetResponseDataRecordingConfigVideoConfigWatermark` Watermark to be added to the recording - `Position MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPosition` Position of the watermark - `const MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPositionLeftTop MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPosition = "left top"` - `const MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPositionRightTop MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPosition = "right top"` - `const MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPositionLeftBottom MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPosition = "left bottom"` - `const MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPositionRightBottom MeetingGetResponseDataRecordingConfigVideoConfigWatermarkPosition = "right bottom"` - `Size MeetingGetResponseDataRecordingConfigVideoConfigWatermarkSize` Size of the watermark - `Height int64` Height of the watermark in px - `Width int64` Width of the watermark in px - `URL string` URL of the watermark image - `Width int64` Width of the recording video in pixels - `SessionKeepAliveTimeInSecs float64` Time in seconds, for which a session remains active, after the last participant has left the meeting. - `Status MeetingGetResponseDataStatus` Whether the meeting is `ACTIVE` or `INACTIVE`. Users will not be able to join an `INACTIVE` meeting. - `const MeetingGetResponseDataStatusActive MeetingGetResponseDataStatus = "ACTIVE"` - `const MeetingGetResponseDataStatusInactive MeetingGetResponseDataStatus = "INACTIVE"` - `SummarizeOnEnd bool` Automatically generate summary of meetings using transcripts. Requires Transcriptions to be enabled, and can be retrieved via Webhooks or summary API. - `Title string` Title of the meeting. - `TranscribeOnEnd bool` Automatically generate transcripts when the meeting ends. - `Paging MeetingGetResponsePaging` - `EndOffset float64` - `StartOffset float64` - `TotalCount float64` - `Success bool` ### Example ```go 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(), "app_id", realtime_kit.MeetingGetParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }, ) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", meeting.Data) } ``` #### Response ```json { "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": { "type": "aws", "auth_method": "KEY", "bucket": "bucket", "host": "host", "password": "password", "path": "path", "port": 0, "private_key": "private_key", "region": "us-east-1", "secret": "secret", "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 } ```