Unknown macro: {next_previous_link3}
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

DescriptionGet the device details of a specific device via the REST API.
Resource Path/name/{name}/{tenatDomain}
URL/mdm-admin/devices/name/{name}/{tenatDomain}
HTTP MethodGET
Request/Response Formatapplication/json
cURL command
curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/mdm-admin/devices/name/{name}/{tenatDomain}
  • 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 {name} of the device. If you are unsure of the name of the device, run the REST API command to get all the device registered with EMM and search for name in the given output. Example: iPad2,1
  • Provide the tenant domain as the value for {tenantDomain}. The default tenant domain of WSO2 EMM is carbon.super. For more information on adding a tenant, see Managing Tenants.

Example:

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer 33392fb365b3ac693b405b565ddc8a3a" -k -v https://localhost:9443/mdm-admin/devices/name/iPad2,1/carbon.super
 Sample output
 > GET /mdm-admin/devices/name/iPad2,1/carbon.super HTTP/1.1
> Host: localhost:9443
> User-Agent: curl/7.43.0
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer 7eac81ad075883838ab88596922f4433
> 
< HTTP/1.1 200 OK
< Cache-Control: private
< Expires: Thu, 01 Jan 1970 05:30:00 IST
< Date: Tue, 23 Feb 2016 09:48:40 GMT
< Content-Type: application/json
< Content-Length: 2760
< Server: WSO2 Carbon Server
< 
* Connection #0 to host localhost left intact
[{"id":1,"name":"iPad2,1","type":"ios","deviceIdentifier":"d607b9c22764ef3af9a33ddd13d0d6cd58a6546a","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":"REFUQQAABORWRVJTAAAABAAAAARUWVBFAAAABAAAAAJVVUlEAAAAEDok+/sZlEtnmLSmlqiTSNBITUNLAAAAKIkEgwM9aN+cM3jB2ihbjAjzscVFZF44KWMRiqb
ObXIk8Uc04cA6aZNXUkFQAAAABAAAAAFTQUxUAAAAFOd7vMcubI+lRqyOeXzIy2+yahrVSVRFUgAAAAQAAMNQVVVJRAAAABARXsKxPWdMBIwUe8tBepAGQ0xBUwAAAAQAAAABV1JBUAAAAAQAAAADS1RZUAAAAAQAAAAAV1BLWQAAACiuli68139Nlyrl
t+sQrex9DyMznbekgBG/YpU88TosPv3ZgTfv+W69VVVJRAAAABCEHODM8odI062wtfGbQCsLQ0xBUwAAAAQAAAACV1JBUAAAAAQAAAADS1RZUAAAAAQAAAABV1BLWQAAACgIv9owdjHQPXLmQCWst2KBRPcAqssL4ljyPuYTFC8HuJEZ845CISkdUEJLW
QAAACDuRydL8f+7Ehpd+n2KpLy98aP61SP4Q7Dyi++QmHZ4X1VVSUQAAAAQG5dvfPt4R5qom+6kCjxTYkNMQVMAAAAEAAAAA1dSQVAAAAAEAAAAA0tUWVAAAAAEAAAAAFdQS1kAAAAoqYP29LSIdJnt+dDks2W284acgooKI6YGrEn94kpRE4OikBuqGs
HsslVVSUQAAAAQO2SMlcsHRg2H9/ARYa0QpENMQVMAAAAEAAAABVdSQVAAAAAEAAAAA0tUWVAAAAAEAAAAAFdQS1kAAAAowsLqZG2TjhAsCL3duV3Yi2FWmYQXP54Kkuf+ZnvYh0oVvpogW836j1VVSUQAAAAQkes/6WvtT+6WdD1y6/9UC0NMQVMAAAA
EAAAABldSQVAAAAAEAAAAA0tUWVAAAAAEAAAAAFdQS1kAAAAocMSprCTMCW8gRk9BB85RBkvc2ECYjAQE83yD0TfObKRRYXIEcZc9vlVVSUQAAAAQ/td2Y08LRm+5cAdoofyh7kNMQVMAAAAEAAAAB1dSQVAAAAAEAAAAA0tUWVAAAAAEAAAAAFdQS1kA
AAAopDVoAk3kl+Cq/6+7A8DkRXYw1EYTfrXB0orsUd9c4dk5vXLo4W0VE1VVSUQAAAAQO7gkjb7QQca6TTEqEKGfq0NMQVMAAAAEAAAACFdSQVAAAAAEAAAAAUtUWVAAAAAEAAAAAFdQS1kAAAAg5j/ChdDxPsg+DWhAYzA5Db0MGWTccHDlfIS96tAk4
2lVVUlEAAAAEKvq0iYL90UiqZL3AC2+pWBDTEFTAAAABAAAAAlXUkFQAAAABAAAAANLVFlQAAAABAAAAABXUEtZAAAAKB6zo5lA4+oS6cwHpjkUNHJcJF+ORWyl/KT7FaRN3pwg4xeBUoBGATxVVUlEAAAAEFLMFkufJkzFsvL+gc6L68BDTEFTAAAABA
AAAApXUkFQAAAABAAAAANLVFlQAAAABAAAAABXUEtZAAAAKG+DmG4RPeuve/Q73R0Cet5wKcqM12QpXPgSTepbNd0U3rAFkSxjAXhVVUlEAAAAEPOZe4L+7UsXuWkHSC+ncwtDTEFTAAAABAAAAAtXUkFQAAAABAAAAAFLVFlQAAAABAAAAABXUEtZAAA
AIAR5oPQTHAlhaFgt0WQVpiKuEiGiNw810CA4LqF+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
Definition 

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

  • No labels