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 me value instead of the userId parameter.
Scopes: phone:read, phone:read:admin, phone_voicemail:read, phone_voicemail:read:admin
Rate Limit Label: Medium
Prerequisites: * A Business or Enterprise account * A Zoom Phone license
Request Params
| 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"}]}