MDM device attributes query

The API queries device attributes. Each query has a category such as MAC address, compliance status, value, and an attribute filter to determine what information to return in the response.

Request

GET /ciscoise/devices/? Content Type Header: application/x-www-form-urlencoded

The maximum number of devices that are returned is the value of query_max_size returned from the MDM server information API. The default value is 5000.

The initial call of this API passes paging information as 0. If the MDM has more devices than the query_max_size, the MDM can design its own paging scheme, and returns the paging_info in the response. This information is part of the URL in the next call from ISE. If the paging information returns a 0 in the response or does not return paging information in the response, all records are returned.

Table 1. MDM device attributes query parameters
Parameter name Required or optional Description
Paging Required 0 is defined as first call or all records.
Querycriteria Optional Choose the query criteria category:
  • Mac address
  • Compliance
Value Optional Choose the query criteria value:
  • Macaddress: 12 HEX without separator.
  • Meid: 14 character HEX code or 10-digit decimal code.
  • Uid: Unique device identifier.
  • Imei: International mobile station equipment identity.
  • Compliance: True or false.
  • Username: String value.
Filter Required Use any number of filters that are separated by +:
  • All
  • Register_status: Boolean value such as true or false.
  • Compliance: Status as true or false.
  • Disk_encryption_on: Boolean value such as true or false.
  • Pin_lock_on: Boolean values such as true or false.
  • Jail_broken: Boolean value such as true or false.
  • Manufacturer: String value.
  • Model: String value.
  • Imei: String value.
  • Meid: String value.
  • Udid: String value.
  • HTTP: Method URL.
  • Serial_number: String value.
  • OS_version: String value.
  • Phone_number: String value.

Sample request

https://services.fiberlink.com/ciscoise/batchdevices/paging=0&querycriteria=macaddress&value=000000000000&filter=all

Sample response

<ise_api > <name>attributes</name> <api_version>2</api_version> <paging_info>0</paging_info> <deviceList> <device> <macaddress>000000000000</macaddress> <attributes> <register_status>true</register_status> <compliance> <status>false<status> <failure_reason>something not compliant</failure_reason> <remediation>instruction on how to rememdiate</remediation> </compliance> <disk_encryption_on>yes</ disk_encryption_on> <pin_lock_on>true</ pin_lock_on> <jail_broken>false</ jail_broken> <manufacturer>Samsung</ manufacturer> <imei>1234567890</imei> <meid>A0123456789012</meid> <udid>2b6f0cc904d137be2e1730235f5664094b831186</udid> <os_version>Android,4.3<os_version> </attributes> </device> <deviceList> </ise_api>