Zoom Public API Documentation
Get user's voicemails
GET {{baseUrl}}/phone/users/:userId/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. For user-level apps, pass the Scopes: Prerequisites:
* A Business or Enterprise account
* A Zoom Phone licenseme value instead of the userId parameter.phone:read, phone:read:admin, phone_voicemail:read, phone_voicemail:read:admin
Rate Limit Label: Medium
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": "2019-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": "2019-05-19T20:00:00Z",
"download_url": "exampleurl.io",
"duration": 18,
"id": "d43520fc6b7e4b26bbeef58a8a80f235",
"status": "read"
}
]
} |
Curl
curl -X GET 'https://api.zoom.us/v2/phone/users/:userId/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