Getting Event Details of a Device

Description Get the event details received by an Android device using this API.

Resource Path

/{deviceIdentifier}

URL mdm-android-agent/events/{deviceIdentifier}

HTTP Method GET

Request/Response Format application/json

cURL command

curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/mdm-android-agent/events/{deviceIdentifier}

For more information on how to generate the <EMM_API_TOKEN>, see Generating the EMM API Token.
By default, <EMM_HOST> is localhost. However, if you are using a public IP, the respective IP address or domain needs to be specified.
By default, <EMM_HTTPS_PORT> has been set to 9443. However, if the port offset has been incremented by n, the default port value needs to be incremented by n.
Provide the device ID as the value for {deviceIdentifier}. For more information, see Retrieving a Device ID.

Example: Retrieve event details that corresponds to the Android device having the 359298055243973 device ID.

curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer d869e4c177f17143748376d54633473"-k -v https://localhose:9443/mdm-android-agent/events/359298055243973

Sample output

> GET /mdm-android-agent/events/352317052330505 HTTP/1.1
> Host: localhost:9443
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer ee189258cea79c86d7656235f30e231d
> 
< HTTP/1.1 200 OK
< Date: Sun, 01 May 2016 05:31:07 GMT
< Content-Type: application/json
< Content-Length: 476
< Server: WSO2 Carbon Server
[{"values":{"_version":"1.0.0","payload":"{\"packageName\":\"com.google.android.apps.docs\",\"state\":\"dataCleared\"}","type":"APPLICATION_STATE",
"deviceIdentifier":"352317052330505"},"id":"f0c867ac-8d49-340f-aed4-ae3a34e7ec3c"},{"values":{"_version":"1.0.0","payload":"{\"packageName\":\"system_server\",\"cpu\":11,\"pid\":2436,\"pss\":0,\"sharedDirty\":0,\"uss\":0}","type":"RUNTIME_STATE",
"deviceIdentifier":"352317052330505"},"id":"b65a65c5-23f9-3258-83be-1745f4d8e0ae"}]

Sample JSON Output Definition

[  
   {  
      "values":{  
         "_version":"1.0.0",
         "payload":"{\"packageName\":\"com.google.android.apps.docs\",\"state\":\"dataCleared\"}",
         "type":"APPLICATION_STATE",
         "deviceIdentifier":"352317052330505"
      },
      "id":"f0c867ac-8d49-340f-aed4-ae3a34e7ec3c"
   },
   {  
      "values":{  
         "_version":"1.0.0",
         "payload":"{\"packageName\":\"system_server\",\"cpu\":11,\"pid\":2436,\"pss\":0,\"sharedDirty\":0,\"uss\":0}",
         "type":"RUNTIME_STATE",
         "deviceIdentifier":"352317052330505"
      },
      "id":"b65a65c5-23f9-3258-83be-1745f4d8e0ae"
   }
]

Property	Definition
`values`	Provides the details of the event.
`_version`	The version of the event stream. The default value is 1.0.0.
`payload`	Defines the payload that was received.
`type`	The type of alert or event that was received.
`deviceIdentifier`	The Android device ID.
`id`	The ID of the respective event stream.