MDM device attributes query for POST request

The API can pass multiple values for specific query criteria. If the query criteria is macaddress, then the API can pass a list of Mac addresses for the query.

Request

POST /ciscoise/batchdevices/? Content Type Header: application/x-www-form-urlencoded

The API is the POST version of the MDM Device Attributes Query API. Functionally, the API equals the GET version.

Table 1. MDM device attributes query parameters for the POST request
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/devices/?paging=0&querycriteria=macaddress&value=000000000000&filter=all https://services.fiberlink.com/ciscoise/devices/?paging=0& querycriteria=meid&value=1234567890abcd&filter=all https://services.fiberlink.com/ciscoise/devices/?paging=0&querycriteria=username&value=abcd1234&filter=register_status+compliance_status https://services.fiberlink.com/ciscoise/devices/?paging=0&querycriteria=compliance&value=false&filter=all https://services.fiberlink.com/ciscoise/devices/?paging=0&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>