List common areas
GET {{baseUrl}}/phone/common_areas?page_size=30&next_page_token=<string>
Lists common areas under an account.
Note: For use by customers who opted for Common Area Optimization
Prerequisites:
- Pro or a higher account with Zoom Phone license
- Account owner or admin permissions
Scopes: phone:read:admin
Granular Scopes: phone:read:common_area:admin
Rate Limit Label: MEDIUM
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
page_size | number | The total number of records returned from a single API call. | |
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. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"common_areas":[{"calling_plans":[{"name":"\u003cstring\u003e","type":"\u003cinteger\u003e","billing_account_id":"\u003cstring\u003e","billing_account_name":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","type":"\u003cinteger\u003e","billing_account_id":"\u003cstring\u003e","billing_account_name":"\u003cstring\u003e"}],"display_name":"\u003cstring\u003e","extension_number":"\u003clong\u003e","id":"\u003cstring\u003e","phone_numbers":[{"display_name":"\u003cstring\u003e","id":"\u003cstring\u003e","number":"\u003cstring\u003e","source":"external"},{"display_name":"\u003cstring\u003e","id":"\u003cstring\u003e","number":"\u003cstring\u003e","source":"internal"}],"site":{"id":"\u003cstring\u003e","name":"\u003cstring\u003e"},"status":"offline","desk_phones":[{"id":"\u003cstring\u003e","display_name":"\u003cstring\u003e","device_type":"\u003cstring\u003e","status":"offline"},{"id":"\u003cstring\u003e","display_name":"\u003cstring\u003e","device_type":"\u003cstring\u003e","status":"offline"}]},{"calling_plans":[{"name":"\u003cstring\u003e","type":"\u003cinteger\u003e","billing_account_id":"\u003cstring\u003e","billing_account_name":"\u003cstring\u003e"},{"name":"\u003cstring\u003e","type":"\u003cinteger\u003e","billing_account_id":"\u003cstring\u003e","billing_account_name":"\u003cstring\u003e"}],"display_name":"\u003cstring\u003e","extension_number":"\u003clong\u003e","id":"\u003cstring\u003e","phone_numbers":[{"display_name":"\u003cstring\u003e","id":"\u003cstring\u003e","number":"\u003cstring\u003e","source":"internal"},{"display_name":"\u003cstring\u003e","id":"\u003cstring\u003e","number":"\u003cstring\u003e","source":"external"}],"site":{"id":"\u003cstring\u003e","name":"\u003cstring\u003e"},"status":"online","desk_phones":[{"id":"\u003cstring\u003e","display_name":"\u003cstring\u003e","device_type":"\u003cstring\u003e","status":"online"},{"id":"\u003cstring\u003e","display_name":"\u003cstring\u003e","device_type":"\u003cstring\u003e","status":"online"}]}],"next_page_token":"\u003cstring\u003e","page_size":"\u003cinteger\u003e"}