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}