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 privileges

Scopes:

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}