Devices Statistics

API version2.0
Last Update09/21/2014
AuthenticationYES
Response FormatJSON
HTTP MethodGET
Rate limitedYES
Requests per rate limit10/min

Use to statistic devices which added/not seen in past X hours.

API URL

Copy

Request Parameters

KeyDatatypeParameter TypeRequiredDescriptionDefault
access_tokenstringURLYesaccess token which archived from OAuth authentication step
eventYes

Specific what devices want to statistic Values are supported

  • added: query devices which added in the query time
  • not_seen: query devices which have not checked in the query time
  • outdated: query devices which running out-of-date agent
optintURLoptionalSpecify which type of the value in "devices" key will be returned in the response Values: 0 - MAC address or 1 - HWID or 3 - SSID0
inintURLoptional

Query duration in second/hour/month/year which specified in "period" parameter. This parameter needs to go along with "period" parameter. For example: query devices in the last month

  • in = 1
  • period = month
periodstringURLoptionalTime unit of the query duration in "in" parameter, which will be used for the calculation. Values: second, hour, month, ytd
start_datedatetimeURLoptionalStarting date of the query duration. Format: YYYYMMDD (in UTC timezone). This parameter needs to go along with end_date parameter.
end_datedatetimeURLoptional

Ending date of the query duration. Format: YYYYMMDD (in UTC timezone) For example: query devices from a date to a date (ex: from 10/01/2016 to 11/01/2016)

  • start_date = 20161001
  • end_date = 20161101
device_typestringURLoptionalValues: all , managed, unmanagedall

Response HTTP Code

See APIs

Response Parameters

KeyDatatypeDescription
total_countintNumber of total devices
devicesarray<string>Lists of devices which added/have not checked in/has out-of-date agent. Values in the array can be mac address, hardware id or SSID based on the "opt" parameter

Example

Example Request:

Copy

Example Response

Copy
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard
Next to read:
Device Action
On This Page
Devices StatisticsAPI URLRequest ParametersResponse HTTP CodeResponse ParametersExample