Get call recordings
GET {{baseUrl}}/phone/recordings?page_size=30&next_page_token=cWiI3vTqdcENiV9RJz3Rh8iP1ksNPheW8c1&from=2021-12-01&to=2021-12-31&owner_type=all&recording_type=OnDemand&site_id=8f71O6rWT8KFUGQmJIFAdQ&query_date_type=start_time
Use this API to list an account's call recordings
Prerequisites:
* A Pro or higher account plan
* A Zoom Phone license
* Account owner or admin privilegesScopes: phone:read:admin
, phone:write:admin
,phone_recording:read:admin
Rate Limit Label: Medium
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
page_size | number | The number of records returned within a single API call. The default is 30, and the maximum is 300. | |
next_page_token | string | The current page number of returned records. | |
from | string | Start time and date in yyyy-mm-dd or yyyy-MM-dd'T'HH:mm:ss'Z' format. The date range defined by the from and to parameters should be a month as the response only includes one month's worth of data at once. If unspecified, returns data from the past 30 days. | |
to | string | Required only when the from parameter is specified. End time and date in yyyy-mm-dd or yyyy-MM-dd'T'HH:mm:ss'Z' format, the same format as the from parameter. | |
owner_type | string | The owner type. The allowed values are null, user , or callQueue . The default is null. If null, returns all owner types. | |
recording_type | string | The recording type. The allowed values are null, OnDemand , or Automatic . The default is null. If null, returns all recording types. | |
site_id | string | The site ID. The default is All sites . | |
query_date_type | string | Query date type, start_time or end_time , default start_time |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"next_page_token":"cWiI3vTqdcENiV9RJz3Rh8iP1ksNPheW8c1","page_size":-24462698,"recordings":[{"call_id":"7072598989368295984","call_log_id":"6f9c2948-40ad-46bc-8700-34ca2d098098","callee_name":"User A","callee_number":"1000001004","callee_number_type":1,"caller_name":"User B","caller_number":"1000123476","caller_number_type":1,"outgoing_by":{"name":"User B","extension_number":"123476"},"accepted_by":{"name":"User A","extension_number":"10201"},"date_time":"2022-03-08T05:37:23Z","direction":"outbound","download_url":"https://domain/recording/download/EvVNLihbQ1WpeG_ALwnNzg","duration":115,"end_time":"2022-03-08T05:39:19Z","id":"6f9c294840ad46bc870034ca2d098098","owner":{"extension_number":1000123476,"id":"NL3cEpSdRc-c2t8aLoZqiw","name":"user@test.com","type":"user","extension_status":"inactive"},"recording_type":"OnDemand","site":{"id":"8f71O6rWT8KFUGQmJIFAdQ","name":"Main Site"},"transcript_download_url":"https://domain/recording_transcript/download/8f7345c50a654182ab1672fdb3be61ff"},{"call_id":"7072598989368295984","call_log_id":"6f9c2948-40ad-46bc-8700-34ca2d098098","callee_name":"User A","callee_number":"1000001004","callee_number_type":1,"caller_name":"User B","caller_number":"1000123476","caller_number_type":1,"outgoing_by":{"name":"User B","extension_number":"123476"},"accepted_by":{"name":"User A","extension_number":"10201"},"date_time":"2022-03-08T05:37:23Z","direction":"outbound","download_url":"https://domain/recording/download/EvVNLihbQ1WpeG_ALwnNzg","duration":115,"end_time":"2022-03-08T05:39:19Z","id":"6f9c294840ad46bc870034ca2d098098","owner":{"extension_number":1000123476,"id":"NL3cEpSdRc-c2t8aLoZqiw","name":"user@test.com","type":"user","extension_status":"inactive"},"recording_type":"OnDemand","site":{"id":"8f71O6rWT8KFUGQmJIFAdQ","name":"Main Site"},"transcript_download_url":"https://domain/recording_transcript/download/8f7345c50a654182ab1672fdb3be61ff"}],"total_records":50}