Get global list

Retrieve a list of items from the global list, based on list type, for a tenant.

Service endpoint

/globallists/v2?listTypeId={{listTypeId}}

Optional query string parameters

  • pageNumber: This is the page number to request.
  • pageSize: This is the number of device records to retrieve per page.

Example

https://protectapi.cylance.com/globallists/v2?listTypeId=[0|1]?pageNumber=1&pageSize=20

Method

HTTP/1.1 GET

Request headers

  • Accept: application/json
  • Authorization: Bearer JWT Token returned by Auth API with the globallist:list scope encoded
Note: The listTypeId parameter is required and can be either 0 (GlobalQuarantine) or 1 (GlobalSafe).

Request

None

Response

Please see the Response status codes for more information.

Response JSON schema

Field Name Description

added

This is the date and time the global list item was added.

avIndustry

category

classification

listType

md5

This is the MD5 hash for the file.

name

This is the name of the global list item.

pageNumber

pageSize

reason

This is the reason for adding the item to the global list.

sha256

This is the SHA256 hash for the file.

subClassification

totalNumberOfItems

totalPages