Zoom Public API Documentation
Get account voicemails
GET {{baseUrl}}/phone/voice_mails?page_size=30&status=read&next_page_token=BJLYC6PABbAHdjwSkGVQeeR6B1juwHqj3G2&from=2020-12-31&to=2021-12-31
Use this API to get a user's Zoom Phone voicemails. Scopes: Prerequisites:
* A Business or Enterprise account
* A Zoom Phone licensephone_voicemail:read:admin
Rate Limit Label: Heavy
Body
PARAM
| Key | Datatype | Required | Description |
page_size
|
number | The number of records returned within a single API call. | |
status
|
string | Status of the voice mail | |
next_page_token
|
string | The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes. | |
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. The month defined should fall within the last six months. 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. |
HEADERS
| Key | Datatype | Required | Description |
Accept
|
string |
RESPONSES
status OK
| {
"from": "2021-05-19",
"next_page_token": "VcXBknJ0MQ7kuXun5WKmSjHC1hOBGS2bbr2",
"page_count": 10,
"page_size": 15,
"to": "2021-06-19",
"total_records": 150,
"voice_mails": [
{
"call_id": "876634343743",
"call_log_id": "46541323465",
"callee_name": "Jane Doe",
"callee_number": "34567889",
"callee_number_type": 2,
"caller_name": "John Doe",
"caller_number": "12345678",
"caller_number_type": 1,
"date_time": "2021-05-19T20:00:00Z",
"download_url": "exampleurl.io",
"duration": 18,
"id": "d43520fc6b7e4b26bbeef58a8a80f235",
"status": "read"
},
{
"call_id": "876634343743",
"call_log_id": "46541323465",
"callee_name": "Jane Doe",
"callee_number": "34567889",
"callee_number_type": 2,
"caller_name": "John Doe",
"caller_number": "12345678",
"caller_number_type": 1,
"date_time": "2021-05-19T20:00:00Z",
"download_url": "exampleurl.io",
"duration": 18,
"id": "d43520fc6b7e4b26bbeef58a8a80f235",
"status": "read"
}
]
} |
Curl
curl -X GET 'https://api.zoom.us/v2/phone/voice_mails?page_size=30&status=read&next_page_token=BJLYC6PABbAHdjwSkGVQeeR6B1juwHqj3G2&from=2020-12-31&to=2021-12-31?page_size=30&status=read&next_page_token=BJLYC6PABbAHdjwSkGVQeeR6B1juwHqj3G2&from=2020-12-31&to=2021-12-31' -H 'Accept: application/json'
ENDPOINTS