Get Logs v3.0

API version3.0
Last Update04/25/2017
AuthenticationYES
HTTP MethodPOST
Content Typeapplication/json
Rate limitedYES
Requests per rate limit10/min
Response FormatJSON

MetaAccess records events on your accounts. There are 2 types of event logs: admin event logs and device event logs. To retrieve event logs on your account, you can use this API. You can set filters in parameters to filter event logs you concern.

API URL

Copy

Request Parameters

KeyDatatypeParameter TypeRequiredDescriptionDefault
access_tokenstringURLYesaccess token which archived from OAuth authentication step
limitintBodyOptionalSpecific maximum number of event logs will be returned in the response. The value should be in [1,50]. If there are more event logs than what the limit asks for, error code will be 406. Event logs in response is ordered by date.20
pageintBodyOptionalSpecific page number which event logs will be returned in. If the requested page exceeds the number of pages of event logs, error code will be 413. It means that the requested page number is too large, no devices will be returned in this case.1
start_datestringBodyOptionalSpecific the start date for the query duration. Starting date of the query. Format: YYYY/MM/DD
end_datestringBodyOptionalSpecific the end date for the query duration. Format: YYYY/MM/DD
ageintBodyOptionalSpecify age of the information in seconds. Maximum value is 86400 (1 day) For example: if you want to query event logs in last 5 minutes, you need to pass age as 300.
filterarray<string>BodyOptional

Specify which events you want to retrieve. Options can be:

  • added: events when a device is added
  • deleted: events when a device is deleted by Admin
  • deleted_user: events when a device is uninstalled by remote users on endpoints
  • unseen: events when a device is deleted by Lost Devices feature (a device is unseen for a long time)
  • compliant: events when a device becomes/changes status to COMPLIANT
  • noncompliant: events when a device becomes/changes status to NON-COMPLIANT

Response HTTP Code

See APIs

Response Parameters

KeyDataTypeDescription
logsarray<object>Lists of event logs
logs.timestampstringtimestamp when the event log occurs
logs.eventstringEvent text
logs.device_idstringHWID of the device which the event occurred on
logs.device_namestringDevice name which the event occurred on
logs.mac_addressesstringMAC address of the device which the event occurred on
logs.detailsarray<string>Event details. The format is: ["category", "application", "version", "status"]

Example

Example Request

Copy

Example Response

Copy

History

VersionURL
v2.0Get Logs v2.0
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard
Next to read:
Get Logs v3.1
On This Page
Get Logs v3.0API URLRequest ParametersResponse HTTP CodeResponse ParametersExampleHistory