GET /phone/devices

List all the desk phone devices that are configured with Zoom Phone on an account. To view devices that have not yet been assigned to a user, set the value of the type query parameter as unassigned and to view devices that have been assigned, set the value as assigned.

Scopes: phone:read:admin
Prerequisites:

Rate Limit Label: Medium

Servers

Query parameters

Name Type Required Description
page_size Integer No

The number of records returned within a single API call.

Default value: 30

type String Yes

State of the device. The value should be either assigned to list devices that have been assigned to user(s) or unassigned to list devices that have not yet been assigned to any user in the Zoom account.

Valid values:

  • "unassigned"
  • "assigned"
next_page_token String No

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.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.