Zoom Public API Documentation
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: Rate Limit Label: phone:read:admin, phone:write:admin,phone_recording:read:adminMedium
Body
PARAM
| 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
} |
Curl
curl -X GET 'https://api.zoom.us/v2/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?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' -H 'Accept: application/json'
ENDPOINTS