Skip Navigation
  1. BlackBerry Docs
  2. Cylance Endpoint Security
  3. Cylance User API guide
  4. Zone API
  5. Get device zones

Get device zones

Request a page with a list of zone resources for a specified device, belonging to a tenant, sorted by the created date, in descending order (most recent user registered listed first). The page number and page size parameters are optional. When the values are not specified, the default values are 1 and 10 respectively. The maximum page size that can be specified is 200 entries per page.
Service Endpoint
/zones/v2/{unique_device_id}/zones?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
return the first page with 100 users: https://protectapi.cylance.com/zones/v2/e378dacb-9324-453a-b8c6-5a8406952195/zones?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 zone:list scope encoded

Request

None

Response

Please see the Response status codes for more information.

Response JSON schema

Field Name
Description
criticality
This is the value of the zone (low, normal, or high).
date_created
This is the date and time (in UTC) when the zone was created.
date_modified
This is the date and time (in UTC) when the zone was last modified.
id
This is the unique ID for the zone.
name
This is the name of the zone.
policy_id
This is the unique ID for the policy assigned to the zone.
update_type
This is the update type for the zone (production, pilot, or test).
zone_rule_id
This is the unique ID for the zone rule created for the zone. Null is displayed if no zone rule exists.