GET {{baseUrl}}/phone/metrics/past_calls?from=<date>&to=<date>&phone_number=<string>&extension_number=<string>&quality_type=good&department=<string>&cost_center=<string>&directions=internal&directions=inbound&durations=0&durations=1&site_id=<string>&page_size=30&next_page_token=<string>
Returns all the call logs metrics of the account from the selected time period. The call logs provide a record of all incoming and outgoing calls over Zoom Phone in an account. You can use query parameters to filter the response by metrics of the call (such as date, phone number, extension number and quality type). Prerequisites:
* Business, or Education account
* Zoom Phone license Scopes: Granular Scopes: Rate Limit Label: phone:read:admin
phone:read:list_call_logs:admin
Heavy
Body
PARAM
Key | Datatype | Required | Description |
from
|
string | The 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. | |
phone_number
|
string | This setting filters call logs of a specified phone number. | |
extension_number
|
string | This setting filters call logs of a specified extension number | |
quality_type
|
string | This setting filters call logs by voice quality. Zoom uses MOS of 3.5 as a general baseline to categorize calls by call quality. A MOS greater than or equal to 3.5 means good quality, while below 3.5 means poor quality. The value of this field can be one of the following: * `good`: Retrieve call logs of the call(s) with good quality of voice. * `bad`: Retrieve call logs of the call(s) with good quality of voice. | |
department
|
string | The department the extension belongs to. | |
|