Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
maxLevel3

Overview

DescriptionGet the iOS device information.
Resource Path/{device_id}
URL/ios/device/{device_id}
HTTP MethodGET
Request/Response Formatapplication/json

 

Sample request

Code Block
titlecURL 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

Code Block
 {
  "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: 

PropertyDescriptionExample

Anchor
id
id
id

The ID given to the application when it is stored in the EMM database.

11

Anchor
name
name
name

The name of the device. 

iPhone4,1

Anchor
type
type
type
 The device typeios

Anchor
deviceIdentifier
deviceIdentifier
deviceIdentifier

 The device ID5b2b244f6758ce764a337dce9966b440b19c0640
Anchor
enrolmentInfo
enrolmentInfo
enrolmentInfo

 The details on the device enrolment.

-
Anchor
properties
properties
properties
 The properties of the specified device.-


enrolmentInfo

PropertyDescriptionExample

Anchor
dateOfEnrolment
dateOfEnrolment
dateOfEnrolment

The date the device was enrolled with WSO2 MDM.

Info

The date is given in the Epoch time format.

1436961547294

Anchor
dateOfLastUpdate
dateOfLastUpdate
dateOfLastUpdate

The date the device was last updated.

Info

The date is given in the Epoch time format.

1436961547294

Anchor
ownership
ownership
ownership

Provides the ownership details.

  • BYOD - Bring your own device (BYOD).
  • COPE - Corporate owned personally enabled (COPE). 
BYOD

Anchor
status
status
status

The state of the device.ACTIVE
Anchor
owner
owner
owner
The owner of the device.foo@bar.com