Getting Details of Registered Devices

Description	Get the details of all the devices that are registered with WSO2 EMM.
Resource Path	`/`
URL	`/mdm-admin/devices/`
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-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 10^th pagination index to the 15^th, 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.