4Getting iOS Device Information

Overview

Description	Get the iOS device information.
Resource Path	`/{device_id}`
URL	`/ios/device/{device_id}`
HTTP Method	`GET`
Request/Response Format	`application/json`

Sample request

cURL command

curl -X GET -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/ios/device/{device_id}

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.

Sample response

 {
  "id": 11,
  "name": "iPhone4,1",
  "type": "ios",
  "deviceIdentifier": "2be702beaaf4ad34fc9e7f8da2b6b808c453fa72b",
  "enrolmentInfo": {
    "dateOfEnrolment": 1436961547294,
    "dateOfLastUpdate": 1436961547294,
    "ownership": "BYOD",
    "status": "ACTIVE",
    "owner": "foo@bar.com"
  },
  "properties": [
    {
      "name": "IMEI"
    },
    {
      "name": "IMSI"
    },
    {
      "name": "DEVICE_MODEL"
    },
    {
      "name": "OS_VERSION"
    },
    {
      "name": "VENDOR"
    },
    {
      "name": "LATITUDE"
    },
    {
      "name": "LONGITUDE"
    },
    {
      "name": "SERIAL"
    },
    {
      "name": "DEVICE_INFO",
      "value": ""
    },
    {
      "name": "UNLOCK_TOKEN",
      "value": "test"
    },
    {
      "name": "MDM_TOKEN",
      "value": "test"
    },
    {
      "name": "DEVICE_NAME",
      "value": ""
    },
    {
      "name": "APNS_PUSH_TOKEN",
      "value": "test"
    },
    {
      "name": "PRODUCT",
      "value": "iPhone"
    },
    {
      "name": "MAGIC_TOKEN",
      "value": "test"
    },
    {
      "name": "ICCID",
      "value": ""
    },
    {
      "name": "LATITUDE",
      "value": ""
    },
    {
      "name": "CHALLENGE_TOKEN",
      "value": ""
    },
    {
      "name": "VERSION",
      "value": "12F70"
    },
    {
      "name": "IMEI",
      "value": "test"
    },
    {
      "name": "MAC_ADDRESS",
      "value": ""
    },
    {
      "name": "LONGITUDE",
      "value": ""
    },
    {
      "name": "SERIAL",
      "value": "test"
    }
  ]
}

Property definitions

All the properties that correspond to the JSON response are explained as follows:

Property	Description	Example
`id`	The ID given to the application when it is stored in the EMM database.	11
`name`	The name of the device.	iPhone4,1
`type`	The device type	ios
`deviceIdentifier`	The device ID	5b2b244f6758ce764a337dce9966b440b19c0640
`enrolmentInfo`	The details on the device enrolment.	-
`properties`	The properties of the specified device.	-

enrolmentInfo

Property	Description	Example
`dateOfEnrolment`	The date the device was enrolled with WSO2 MDM. The date is given in the Epoch time format.	1436961547294
`dateOfLastUpdate`	The date the device was last updated. The date is given in the Epoch time format.	1436961547294
`ownership`	Provides the ownership details. BYOD - Bring your own device (BYOD). COPE - Corporate owned personally enabled (COPE).	BYOD
`status`	The state of the device.	ACTIVE
`owner`	The owner of the device.	foo@bar.com