--- title: Fetch all meetings for an App --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Realtime Kit](https://developers.cloudflare.com/api/python/resources/realtime_kit) [Meetings](https://developers.cloudflare.com/api/python/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 realtime\_kit.meetings.get(strapp\_id, MeetingGetParams\*\*kwargs) -> [MeetingGetResponse]() 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 account\_id: str The account identifier tag. maxLength32 [Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) app\_id: str 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)>) end\_time: Optional\[Union\[str, datetime]] 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](<#(resource)%20realtime_kit.meetings%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20end_time%20%3E%20(schema)>) page\_no: Optional\[float] The page number from which you want your page search results to be displayed. minimum0 [Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20page_no%20%3E%20(schema)>) per\_page: Optional\[float] Number of results per page minimum0 [Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) search: Optional\[str] The search query string. You can search using the meeting ID or title. [Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20search%20%3E%20(schema)>) start\_time: Optional\[Union\[str, datetime]] 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](<#(resource)%20realtime_kit.meetings%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20start_time%20%3E%20(schema)>)
status: Optional\[Literal\["ACTIVE", "INACTIVE"]] Filter meetings by status. One of the following: "ACTIVE" Link to this property "INACTIVE" Link to this property
[Link to this property](<#(resource)%20realtime_kit.meetings%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class MeetingGetResponse: …
data: List\[Data] id: str ID of the meeting. formatuuid Link to this property created\_at: datetime Timestamp the object was created at. The time is returned in ISO format. formatdate-time Link to this property updated\_at: datetime Timestamp the object was updated at. The time is returned in ISO format. formatdate-time Link to this property live\_stream\_on\_start: Optional\[bool] Specifies if the meeting should start getting livestreamed on start. Link to this property persist\_chat: Optional\[bool] Specifies if Chat within a meeting should persist for a week. Link to this property record\_on\_start: Optional\[bool] Specifies if the meeting should start getting recorded as soon as someone joins the meeting. Link to this property
recording\_config: Optional\[DataRecordingConfig] Recording Configurations to be used for this meeting. This level of configs takes higher preference over App level configs on the RealtimeKit developer portal.
audio\_config: Optional\[DataRecordingConfigAudioConfig] Object containing configuration regarding the audio that is being recorded.
channel: Optional\[Literal\["mono", "stereo"]] Audio signal pathway within an audio file that carries a specific sound source. One of the following: "mono" Link to this property "stereo" Link to this property
Link to this property
codec: Optional\[Literal\["MP3", "AAC"]] 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: "MP3" Link to this property "AAC" Link to this property
Link to this property export\_file: Optional\[bool] Controls whether to export audio file seperately Link to this property
Link to this property file\_name\_prefix: Optional\[str] Adds a prefix to the beginning of the file name of the recording. Link to this property
live\_streaming\_config: Optional\[DataRecordingConfigLiveStreamingConfig] rtmp\_url: Optional\[str] RTMP URL to stream to formaturi Link to this property
Link to this property max\_seconds: Optional\[float] 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
realtimekit\_bucket\_config: Optional\[DataRecordingConfigRealtimekitBucketConfig] 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
storage\_config: Optional\[DataRecordingConfigStorageConfig] One of the following:
class DataRecordingConfigStorageConfigUnionMember0: … access\_key: Optional\[str] 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
auth\_method: Optional\[Literal\["KEY", "PASSWORD"]] Authentication method used for “sftp” type storage medium One of the following: "KEY" Link to this property "PASSWORD" Link to this property
Link to this property bucket: Optional\[str] Name of the storage medium’s bucket. Link to this property host: Optional\[str] SSH destination server host for SFTP type storage medium Link to this property password: Optional\[str] 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: Optional\[str] Path relative to the bucket root at which the recording will be placed. Link to this property port: Optional\[float] SSH destination server port for SFTP type storage medium Link to this property private\_key: Optional\[str] 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: Optional\[str] Region of the storage medium. Link to this property secret: Optional\[str] Secret key of the storage medium. Similar to access_key, it is only writeable by clients, not readable. Link to this property type: Optional\[Literal\["gcs"]] Link to this property username: Optional\[str] SSH destination server username for SFTP type storage medium Link to this property
Link to this property
class DataRecordingConfigStorageConfigUnionMember1: … access\_key: object minLength1 Link to this property region: object minLength1 Link to this property
auth\_method: Optional\[Literal\["KEY", "PASSWORD"]] Authentication method used for “sftp” type storage medium One of the following: "KEY" Link to this property "PASSWORD" Link to this property
Link to this property bucket: Optional\[str] Name of the storage medium’s bucket. Link to this property host: Optional\[str] SSH destination server host for SFTP type storage medium Link to this property password: Optional\[str] 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: Optional\[str] Path relative to the bucket root at which the recording will be placed. Link to this property port: Optional\[float] SSH destination server port for SFTP type storage medium Link to this property private\_key: Optional\[str] 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: Optional\[str] Secret key of the storage medium. Similar to access_key, it is only writeable by clients, not readable. Link to this property
type: Optional\[Literal\["aws", "azure", "digitalocean"]] One of the following: "aws" Link to this property "azure" Link to this property "digitalocean" Link to this property
Link to this property username: Optional\[str] SSH destination server username for SFTP type storage medium Link to this property
Link to this property
class DataRecordingConfigStorageConfigUnionMember2: … private\_key: str Private key used to login to destination SSH server for SFTP type storage medium, when auth\_method used is “KEY” Link to this property access\_key: Optional\[str] 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 auth\_method: Optional\[Literal\["KEY"]] Link to this property bucket: Optional\[str] Name of the storage medium’s bucket. Link to this property host: Optional\[str] SSH destination server host for SFTP type storage medium Link to this property password: Optional\[str] 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: Optional\[str] Path relative to the bucket root at which the recording will be placed. Link to this property port: Optional\[float] SSH destination server port for SFTP type storage medium Link to this property region: Optional\[str] Region of the storage medium. Link to this property secret: Optional\[str] Secret key of the storage medium. Similar to access_key, it is only writeable by clients, not readable. Link to this property
type: Optional\[Literal\["aws", "azure", "digitalocean", 2 more]] Type of storage media. One of the following: "aws" Link to this property "azure" Link to this property "digitalocean" Link to this property "gcs" Link to this property "sftp" Link to this property
Link to this property username: Optional\[str] SSH destination server username for SFTP type storage medium Link to this property
Link to this property
class DataRecordingConfigStorageConfigUnionMember3: … password: str 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 access\_key: Optional\[str] 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 auth\_method: Optional\[Literal\["PASSWORD"]] Link to this property bucket: Optional\[str] Name of the storage medium’s bucket. Link to this property host: Optional\[str] SSH destination server host for SFTP type storage medium Link to this property path: Optional\[str] Path relative to the bucket root at which the recording will be placed. Link to this property port: Optional\[float] SSH destination server port for SFTP type storage medium Link to this property private\_key: Optional\[str] 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: Optional\[str] Region of the storage medium. Link to this property secret: Optional\[str] Secret key of the storage medium. Similar to access_key, it is only writeable by clients, not readable. Link to this property
type: Optional\[Literal\["aws", "azure", "digitalocean", 2 more]] Type of storage media. One of the following: "aws" Link to this property "azure" Link to this property "digitalocean" Link to this property "gcs" Link to this property "sftp" Link to this property
Link to this property username: Optional\[str] SSH destination server username for SFTP type storage medium Link to this property
Link to this property
Link to this property
video\_config: Optional\[DataRecordingConfigVideoConfig]
codec: Optional\[Literal\["H264", "VP8", "VP9"]] Codec using which the recording will be encoded. One of the following: "H264" Link to this property "VP8" Link to this property "VP9" Link to this property
Link to this property export\_file: Optional\[bool] Controls whether to export video file seperately Link to this property height: Optional\[int] Height of the recording video in pixels maximum1920 minimum1 Link to this property
watermark: Optional\[DataRecordingConfigVideoConfigWatermark] Watermark to be added to the recording
position: Optional\[Literal\["left top", "right top", "left bottom", "right bottom"]] Position of the watermark One of the following: "left top" Link to this property "right top" Link to this property "left bottom" Link to this property "right bottom" Link to this property
Link to this property
size: Optional\[DataRecordingConfigVideoConfigWatermarkSize] Size of the watermark height: Optional\[int] Height of the watermark in px minimum1 Link to this property width: Optional\[int] Width of the watermark in px minimum1 Link to this property
Link to this property url: Optional\[str] URL of the watermark image formaturi Link to this property
Link to this property width: Optional\[int] Width of the recording video in pixels maximum1920 minimum1 Link to this property
Link to this property
Link to this property session\_keep\_alive\_time\_in\_secs: Optional\[float] Time in seconds, for which a session remains active, after the last participant has left the meeting. maximum600 minimum60 Link to this property
status: Optional\[Literal\["ACTIVE", "INACTIVE"]] Whether the meeting is ACTIVE or INACTIVE. Users will not be able to join an INACTIVE meeting. One of the following: "ACTIVE" Link to this property "INACTIVE" Link to this property
Link to this property summarize\_on\_end: Optional\[bool] 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: Optional\[str] Title of the meeting. Link to this property transcribe\_on\_end: Optional\[bool] Automatically generate transcripts when the meeting ends. Link to this property
Link to this property
paging: Paging end\_offset: float Link to this property start\_offset: float Link to this property total\_count: float 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)%20meeting_get_response%20%3E%20(schema)>) ### Fetch all meetings for an App Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) meeting = client.realtime_kit.meetings.get( app_id="14a396e7-ca44-4937-bf1f-050a69118543", account_id="023e105f4ecef8ad9ca31a8372d0c353", ) print(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 } ```