Skip Navigation
  1. BlackBerry Docs
  2. Cylance Endpoint Security
  3. Cylance User API guide
  4. Device API
  5. Get zone devices

Get zone devices

Request a page with a list of console device resources belonging to a zone, sorted by registration (created) date, in descending order (most recent registered listed first). The page number and page size parameters are optional. When the values are not specified, these default to 1 and 10 respectively. The maximum page size that can be specified is 200 entries per page.
Service endpoint
/devices/v2/{unique_zone_id}/devices?page=m&page_size=n
Optional query string parameters
  • page: This is the page number to request.
  • page_size: This is the number of device records to retrieve per page.
Example
https://protectapi.cylance.com/devices/v2/d27ff5c4-5c0d-4f56-a00d-a1fb297e440e/devices?page=1&page_size=100
Method
HTTP/1.1 GET
Request headers
  • Accept: application/json
  • Authorization: Bearer
    JWT Token returned by Auth API
     with the device:list scope encoded

Request

None

Response

Please see the Response status codes for more information.

Response JSON schema

Field Name
Description
id
This is the unique identifier for the device.
name
This is the name of the device.
page_number
This is the page number requested.
page_size
This is the page size requested.
policy_id
This is the unique identifier for the policy that the policy is currently assigned to (can be assigned as null).
total_number_of_items
This is the total number of resources.
total_pages
This is the total number of pages that can be retrieved, based on the page size specified.