Logo
Zoom Public API Documentation

List queue recordings

GET {{baseUrl}}/contact_center/queues/:queueId/recordings?channel_type=voice&from=<string>&to=<string>&next_page_token=<string>&page_size=30

Return a list of all recordings in a queue.

Note: Use recording-related APIs to manipulate data whose recording creation time is after 2022-07-18.

Scopes: contact_center_recording:read:admin

Rate Limit Label: Medium

 

Body PARAM

Key Datatype Required Description 
channel_type
string The recording's channel type. * `voice` &mdash; Voice recording * `video` &mdash; Video recording
from
string The start time and date in ISO 8601 format: yyyy-MM-dd'T'HH:mm:ss'Z', or yyyy-MM-dd'T'HH:mm:ss'TZD'. The defined date range should be a month, as the response only includes one month's worth of data. If unspecified, this parameter returns data from the past 30 days.
to
string **Required** only when the `from` parameter is specified. The end time and date in ISO 8601 format: yyyy-MM-dd'T'HH:mm:ss'Z', or yyyy-MM-dd'T'HH:mm:ss'TZD', the same format as the `from` parameter.
next_page_token
string Use the next page token to paginate through large result sets. A next page token returns whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.
page_size
number The number of items returned per page.



HEADERS

Key Datatype Required Description 
Accept
string




RESPONSES

status OK

{ "next_page_token": "<string>", "page_size": 30, "from": "<string>", "to": "<string>", "recordings": [ { "recording_id": "<string>", "queue_id": "<string>", "queue_name": "<string>", "recording_duration": "<integer>", "download_url": "<string>", "transcript_url": "<string>", "playback_url": "<string>", "recording_start_time": "<dateTime>", "recording_end_time": "<dateTime>", "user_id": "<string>", "user_email": "<string>", "display_name": "<string>", "recording_type": "on_demand", "channel_type": "video", "direction": "outbound", "owner_id": "<string>", "owner_name": "<string>", "owner_type": "user", "engagement_id": "<string>", "flow_name": "<string>", "flow_id": "<string>", "consumer_name": "<string>", "consumer_number": "<string>", "consumers": [ { "consumer_name": "<string>", "consumer_number": "<string>" }, { "consumer_name": "<string>", "consumer_number": "<string>" } ] }, { "recording_id": "<string>", "queue_id": "<string>", "queue_name": "<string>", "recording_duration": "<integer>", "download_url": "<string>", "transcript_url": "<string>", "playback_url": "<string>", "recording_start_time": "<dateTime>", "recording_end_time": "<dateTime>", "user_id": "<string>", "user_email": "<string>", "display_name": "<string>", "recording_type": "automatic", "channel_type": "voice", "direction": "outbound", "owner_id": "<string>", "owner_name": "<string>", "owner_type": "queue", "engagement_id": "<string>", "flow_name": "<string>", "flow_id": "<string>", "consumer_name": "<string>", "consumer_number": "<string>", "consumers": [ { "consumer_name": "<string>", "consumer_number": "<string>" }, { "consumer_name": "<string>", "consumer_number": "<string>" } ] } ] }



Curl
curl -X GET 'https://api.zoom.us/v2/contact_center/queues/:queueId/recordings?channel_type=voice&from=<string>&to=<string>&next_page_token=<string>&page_size=30?channel_type=voice&from=<string>&to=<string>&next_page_token=<string>&page_size=30' -H 'Accept: application/json'

ENDPOINTS