Get operation logs report

The Phone System operation logs report allows account owners and admins to view monthly Zoom phone related admin operation details.

Use this API to retrieve the Phone System Operation Logs Report. Account owners and admins can also access this information by logging into their Zoom accounts and navigating to Phone System Operation Logs.

Scopes: phone:read:admin, phone:write:admin
Rate Limit Label: Heavy

Prerequisites:

Account must be enrollled in Pro or a higher plan

Account must be enrolled in a Zoom Phone plan

{ "from": "2020-08-01", "next_page_token": "abcD3944YsoYPB12", "operation_logs": [ { "action": "UPDATE", "category_type": "Phone Number", "operation_detail": "Unbind Phone Number +1112222 From Not_Delete_CallQueue_Recording", "operator": "apbchd@mail123a.com", "time": "2020-08-24T06:15:12Z" }, { "action": "DELETE", "category_type": "Phone Number", "operation_detail": "Delete Phone Number +123456 From abc.zoom.us", "operator": "apbchd@mail123a.com", "time": "2020-08-24T06:13:30Z" }, { "action": "ADD", "category_type": "Device", "operation_detail": "Add Device testDevice", "operator": "apbcdef@mail123a.com", "time": "2020-08-11T03:13:17Z" }, { "action": "UPDATE", "category_type": "Phone Number", "operation_detail": "Assign Phone Number +120000123 to Sam Mendes(abcdaccount@someaccount.com)", "operator": "apapbchd@mail123a.com", "time": "2020-08-06T08:29:45Z" } ], "page_size": 15, "to": "2020-08-30", "total_records": 16 }

请求参数

Query 参数

from

string

可选

Start date in 'yyyy-mm-dd' format. The date range defined by the "from" and "to" parameters should only be one month as the report provides only one month worth of data per API request.

string

可选

End date in 'yyyy-mm-dd' format.

category_type

string

可选

Filter the response by the category of the action performed. By default, the value of this field is "all" and thus, the response will include log of all operations for the defined period.

To only include response for a specific category type, provide a value for category_type from this table.

默认值:

all

page_size

integer

可选

The number of records returned within a single API call.

<= 300

默认值:

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.

返回响应

🟢200**HTTP Status Code:** `200`<br> Report returned.

application/json

Body

Pagination object.

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 the available result list exceeds the page size. The expiration period is 15 minutes.

page_size

integer

可选

The amount of records returns within a single API call.

<= 300

默认值:

operation_logs

array [object {5}]

可选

Array of operation log objects

action

string

可选

Action that was performed.

category_type

string

可选

Category type of the operation.

operation_detail

string

可选

Operation detail.

operator

string

可选

The user who performed the operation.

time

string <date-time>

可选

The time at which the operation was performed.

🟠404**HTTP Status Code:** `404`<br> **Error Code**: `124`<br> Account does not exist: {accountId}.