com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_link3' is unknown.

Getting Details of Registered Devices

Owned by Former user (Deleted)
Last updated: Apr 05, 2016
2 min read
DescriptionGet the details of all the devices that are registered with WSO2 EMM.
Resource Path/
URL/mdm-admin/devices/
HTTP MethodGET
Request/Response Formatapplication/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-admin/devices/
  • 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.

Example:

curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a" -k -v https://localhost:9443/mdm-admin/devices/

Filter the device details using the query parameters given below:

  • type - Provide the device type, such as ios, android or windows.
  • user - Get the details of the devices registered to a user by providing the user name.
  • role - Get the details of the devices registered to a specific role by providing the role name.
  • status - Provide the device status details, such as active or inactive.

  • start - Provide the starting pagination index. Example 10

    You will have many devices registered with the EMM. In a situation where you wish to view the all the registered devices it is not feasible to show all the details on one page therefore the details are paginated.

  • length - Provide how many device details you require from the starting pagination index. For example if you require the device details from the 10th pagination index to the 15th, you must define 10 as the value for start and 5 as the value for length.

    If you wish to get the device details within a predefined index range you need to define both the start and length fields.
    Example: https://localhost:9443/mdm-admin/devices?start=10&length=5
    There will be situations were you will not have device details in the specified index range. In such situation all the details of the devices registered to EMM will be given.

  • device-name - Provide the name of a registered device and receive the specified device details.

  • ownership - Provide the device ownership type and receive the specific device details. WSO2 EMM registers devices under the BYOD or COPE ownership type.

Example: Getting all the device details that belong to the Android platform and are in the active state.

curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a" -k -v https://localhost:9443/mdm-admin/devices?type=android&status=active

Example: Getting all the device details by filtering it using all the criteria given above.

curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a" -k -v https://localhost:9443/mdm-admin/devices?type=android&user=kim&role=admin&status=active&start=10&length=5&device-name=deviceAndroid&ownership=BYOD
 Sample output
> GET /mdm-admin/devices/ HTTP/1.1
> Host: localhost:9443
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer 25ef46042442ed1ace0407e347a00116
< HTTP/1.1 200 OK
< Cache-Control: private
< Expires: Thu, 01 Jan 1970 05:30:00 IST
< Date: Tue, 23 Feb 2016 08:46:30 GMT
< Content-Type: application/json
< Content-Length: 2760
< Server: WSO2 Carbon Server
[{"id":1,"name":"iPad2,1","type":"ios","deviceIdentifier":"f409r4c55924rt4af9a44tts15y9d6cd56h1047d","enrolmentInfo":{"id":1,"dateOfEnrolment":1455530367905,
"dateOfLastUpdate":1455530929113,"ownership":"BYOD","status":"ACTIVE","owner":"admin"},"properties":[{"name":"IMEI"},{"name":"IMSI"},{"name":"DEVICE_MODEL"},
{"name":"OS_VERSION"},{"name":"VENDOR"},{"name":"SERIAL"},{"name":"DEVICE_INFO","value":""},{"name":"UNLOCK_TOKEN","value":"REFUQQAABORWRVJTAAAABAAAAARUWVBF
AAAABAAAAAJVVUlEAAAAEDok+/sZlEtnmLSmlqiTSNBITUNLAAAAKIkEgwM9aN+cM3jB2ihbjAjzscVFZF44KWMRiqbObXIk8Uc04cA6aZNXUkFQAAAABAAAAAFTQUxUAAAAFOd7vMcubI+lRqyOeXzIy2+y
ahrVSVRFUgAAAAQAAMNQVVVJRAAAABARXsKxPWdMBIwUe8tBepAGQ0xBUwAAAAQAAAABV1JBUAAAAAQAAAADS1RZUAAAAAQAAAAAV1BLWQAAACiuli68139Nlyrlt+sQrex9DyMznbekgBG/YpU88TosPv3Z
gTfv+W69VVVJRAAAABCEHODM8odI062wtfGbQCsLQ0xBUwAAAAQAAAACV1JBUAAAAAQAAAADS1RZUAAAAAQAAAABV1BLWQAAACgIv9owdjHQPXLmQCWst2KBRPcAqssL4ljyPuYTFC8HuJEZ845CISkdUEJL
WQAAACDuRydL8f+7Ehpd+n2KpLy98aP61SP4Q7Dyi++QmHZ4X1VVSUQAAAAQG5dvfPt4R5qom+6kCjxTYkNMQVMAAAAEAAAAA1dSQVAAAAAEAAAAA0tUWVAAAAAEAAAAAFdQS1kAAAAoqYP29LSIdJnt+dDk
s2W284acgooKI6YGrEn94kpRE4OikBuqGsHsslVVSUQAAAAQO2SMlcsHRg2H9/ARYa0QpENMQVMAAAAEAAAABVdSQVAAAAAEAAAAA0tUWVAAAAAEAAAAAFdQS1kAAAAowsLqZG2TjhAsCL3duV3Yi2FWmYQX
P54Kkuf+ZnvYh0oVvpogW836j1VVSUQAAAAQkes/6WvtT+6WdD1y6/9UC0NMQVMAAAAEAAAABldSQVAAAAAEAAAAA0tUWVAAAAAEAAAAAFdQS1kAAAAocMSprCTMCW8gRk9BB85RBkvc2ECYjAQE83yD0TfO
bKRRYXIEcZc9vlVVSUQAAAAQ/td2Y08LRm+5cAdoofyh7kNMQVMAAAAEAAAAB1dSQVAAAAAEAAAAA0tUWVAAAAAEAAAAAFdQS1kAAAAopDVoAk3kl+Cq/6+7A8DkRXYw1EYTfrXB0orsUd9c4dk5vXLo4W0V
E1VVSUQAAAAQO7gkjb7QQca6TTEqEKGfq0NMQVMAAAAEAAAACFdSQVAAAAAEAAAAAUtUWVAAAAAEAAAAAFdQS1kAAAAg5j/ChdDxPsg+DWhAYzA5Db0MGWTccHDlfIS96tAk42lVVUlEAAAAEKvq0iYL90Ui
qZL3AC2+pWBDTEFTAAAABAAAAAlXUkFQAAAABAAAAANLVFlQAAAABAAAAABXUEtZAAAAKB6zo5lA4+oS6cwHpjkUNHJcJF+ORWyl/KT7FaRN3pwg4xeBUoBGATxVVUlEAAAAEFLMFkufJkzFsvL+gc6L68BD
TEFTAAAABAAAAApXUkFQAAAABAAAAANLVFlQAAAABAAAAABXUEtZAAAAKG+DmG4RPeuve/Q73R0Cet5wKcqM12QpXPgSTepbNd0U3rAFkSxjAXhVVUlEAAAAEPOZe4L+7UsXuWkHSC+ncwtDTEFTAAAABAAA
AAtXUkFQAAAABAAAAAFLVFlQAAAABAAAAABXUEtZAAAAIAR5oPQTHAlhaFgt0WQVpiKuEiGiNw810CA4LqF+sR4TU0lHTgAAABTCz+wpGk5UMQiOyYf7BMRT+P9dgg\u003d\u003d"},{"name":"MDM_TOKEN","value":"XCKB3DbVBGCzJGdi3ynhAvIiYLDn5j4b1tDufA98miA\u003d"},{"name":"DEVICE_NAME","value":""},{"name":"APNS_PUSH_TOKEN","value":"45f6d60f6394cf129d7e56bb176d8a34bfecb120345b2b1719d4d9df2b4fd8d2"},{"name":"PRODUCT","value":"iPad"},{"name":"MAGIC_TOKEN","value":"EF9A5A51-F6DC-4D3C-BAF4-139E4C50BAEA"},{"name":"ICCID","value":""},{"name":"LATITUDE","value":""},{"name":"CHALLENGE_TOKEN","value":""},{"name":"VERSION","value":"12F69"},{"name":"IMEI","value":""},{"name":"MAC_ADDRESS","value":""},{"name":"LONGITUDE","value":""},{"name":"SERIAL","value":"DN6G9LG1DFHW"}]}]
Sample JSON Output
Definition 

To know more on iOS specific device details, see the iOS device information property definition.

com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'next_previous_links2' is unknown.