Android Details Key Value Descriptions
The following table shows the key-value pairs in the <details> element for Android devices. The set of key-value pairs and the order they appear in the response can vary according to the type of device. Therefore, the table presents the pairs in alphabetical order by the key name.
If a key-value pair is not applicable for a device, typically the HTTP response does not include the pair.
The Ivanti EPMM Admin Guide has more information about fields that are available in the Admin Portal.
Key Name | Key Description | Value |
|---|---|---|
admin_activated | Whether device administrator privilege is activated for the Ivanti EPMM client on the device. | true false |
battery_life | Power remaining in the battery life. | The percentage of power remaining in the battery. Example: 100 |
board | The name of the underlying board on the Android device. | A name that the Android OS provides. Example: venus2 |
brand | The brand (e.g., carrier) the Android software is customized for, if any. | A string that the Android OS provides. Example: verizon |
c2dmToken | Android C2DM registration ID for the device. | A string of characters |
client_name | Name of Ivanti EPMM client application on the device. | Example: com.mobileiron |
client_version | Ivanti EPMM client version number running on the device. | Example: 4.5.0 |
codename | Android platform’s current development codename, or the string "REL" if this is a release build. | Example: REL |
country_code | The device’s Mobile Country Codes (MCCs). MCCs are defined in ITU E.212. | Example for United States: 310 |
current_mobile_number | Phone number of the device | Example: 6505551212 |
current_operator_name | Name of current registered operator. | Example: Verizon Wireless |
current_SIM_module_number | International Mobile Subscriber Identity number for the device. | Example: 262014530204577 |
device | The name of the industrial design of the device. | A string that the Android OS provides. Examples: cdma_droid2 cdma_shadow |
device_id | Unique identifier for the device | Example: ddc865b69c13eeb4 |
device_manufacturer | Manufacturer of the device. | Example: motorola |
device_model | Model of the Android device | Example: DROID2 |
device_roaming_flag | Whether the device is roaming. | on – The device is roaming. off -- The device is not roaming. |
device_type | Whether the device uses CDMA or GSM technology to transmit voice calls. If the device does not transmit voice calls, this fields whether the device uses CDMA or GSM technology is transmit data. | CDMA or GSM |
display_size | Size of the device’s display | Dimensions in pixels, in the format: <height>X<width> Example: 854X480 |
free_media_card_size | Amount of unused storage on the media card on the device. | Number in bytes Example: 2.36M |
free_media_card_size_bytes | Amount of unused storage on the media card on the device. | Number in bytes Example: 104857000 |
free_ram_size | Amount of RAM available on the device. | Number of megabytes, shown with M suffix. Example: 5.84M |
free_ram_size_bytes | Amount of unused RAM memory on the device. | Number in bytes. Example: 104857000 |
free_storage_size | Amount of unused storage on the device | Number in bytes Example: 6489.68M |
free_storage_size_bytes | Size of unused storage on the device. | Number in bytes. Example: 104857000 |
home_operator | Home service provider for the device | The service provider name, mobile country code and mobile network code of the provider in the following format: <name>::<MCC+MNC> Example: Verizon::310004 |
imei | International Mobile Equipment Identity of the device. | Example: A00000226EBF9F |
imsi | International Mobile Subscriber Identity number for the device. | Example: 262018410218015 |
incremental | Android platform version’s build number. | Example: 110719 |
lat_long_last_captured_at | The last time the location of the device was recorded. | Specified as seconds since January 1, 1970. Example: 1324421860972 |
latitude | Latitude of the device’s location. | Degrees latitude. Example: 37.396074 |
locale | Locale for the device | Examples: en-US en |
longitude | Longitude of the device’s location. | Degrees longitude Example: -122.056339 |
mdm_enabled | Whether the Ivanti EPMM client is fully configured on the device. Note: The Ivanti EPMM client can be installed and running, but still unable to manage the device if it is not fully configured. | true – The Ivanti EPMM client is fully configured. false – The Ivanti EPMM client is not fully configured. |
multi_mdm | Whether multiple Device Admin applications are active on the device. | true – More than one Device Admin application are active. False – One or zero Device Admin Applications are active. |
network_id | CDMA network identification number. | Example: 6 |
os_version | The Android SDK version code | Example: 10 The value 10 corresponds to Android 2.3.3. Values are defined on http://developer.android.com. |
platform_name | Android platform version number on the device. | Example: 2.3.3 |
processor_architecture | Processor architecture of the device. | armeabi-v7a |
prv_bluetooth | Whether the lockdown policy for the device has disabled access to Bluetooth. | ON – Access to Bluetooth is enabled for both audio and data. AUDIO – Access to Bluetooth is enabled for audio only. OFF – Access to Bluetooth is disabled. unsupported – The Ivanti EPMM client does not support enabling or disabling Bluetooth on the device. |
prv_camera | Whether the lockdown policy for the device has disabled access to the camera. | ON – Access to the camera is enabled. OFF – Access to the camera is disabled. unsupported – The Ivanti EPMM client does not support enabling or disabling the camera on the device. |
prv_device_encryption | Whether the security policy for the device has enabled data encryption on the device. | on – Device encryption is enabled. off -- Device encryption is not enabled. unsupported – The Ivanti EPMM client does not support enabling or disabling data encryption on the device. |
prv_exchange_Domain | Domain of the email server of the device’s user. | Email server domain. For example: MOBILEIRON If the email client is not yet configured, the value is na. If the email client is not supported by Ivanti EPMM, then the response does not include this key-value pair. |
prv_exchange_Server | Email server for the device’s user. | Email server address. For example: mail.Ivanti.com If the email client is not yet configured, the value is na. If the email client is not supported by Ivanti EPMM, then the response does not include this key-value pair. |
prv_exchange_UserName | Email user name of the device’s user. | Email user name. For example: [email protected] If the email client is not yet configured, the value is na. If the email client is not supported by Ivanti EPMM, then the response does not include this key-value pair. |
prv_exchange_UseSSL | Whether email transport uses Secure Socket Layer. | ON – Email uses the Secure Socket Layer. The value is ON if Ivanti EPMM supports the email client and the email client is configured. If the email client is not yet configured, the value is na. If the email client is not supported by Ivanti EPMM, then the response does not include this key-value pair. |
prv_max_failed_attempts | Maximum number of times the user can enter an incorrect password before the device is wiped. | The maximum number, or the value 0 if no maximum exists. This value is applicable only if prv_password_type indicates that a password is mandatory. |
prv_max_idle_time | Maximum time the device can be inactive before the user must re-enter the password. | Number of minutes Example: 30 This value is applicable only if prv_password_type indicates that a password is mandatory. |
prv_password | 1. A password is mandatory for the user to access the device, as specified in the device’s security policy. 2. The device is compliant with the security policy. Whether both of the following conditions are true: | ON – Both conditions are true. OFF – One or both of the conditions are not true. |
prv_password_expiration_timeout | Numbers of days after which the device’s password will expire. | The number of days, or the value unsupported if a password is optional. Example: 30 This value is applicable only if prv_password_type indicates that a password is mandatory. |
prv_password_history_length | Number of passwords remembered to ensure that the device’s user define a different password. For example, the value 4 prevents the user from repeating a password for the next four password changes. | A number, or the value unsupported if a password is optional. This value is applicable only if prv_password_type indicates that a password is mandatory. |
prv_password_length | Minimum length for the device’s password. | Number between 1 and 10, or -1 which indicates the password has no minimum length. This value is applicable only if prv_password_type indicates that a password is mandatory. |
prv_password_minimum_symbols | Minimum number of special characters that must be included in a password. Applicable only to Android 3.0 and higher. | A number or the value unsupported if no minimum is required. This value is applicable only if prv_password_type indicates that a password is mandatory. |
prv_password_type | Whether the device’s password is mandatory, and whether it must be restricted to simple numeric input, alphanumeric characters, or has no restrictions. The security policy assigned to the device specifies the password type. | 0 – password is mandatory and is restricted to alphanumeric characters. 1 – password is mandatory and is restricted to simple numeric characters. 2 – password is mandatory and has no character restrictions. -1 – password is optional. |
prv_sd_encryption | Whether the security policy for the device has enabled encrypting the contents of the SD (Secure Data card) on the device. | on – SD encryption is enabled. off -- SD encryption is not enabled. unsupported – The Ivanti EPMM client does not support enabling or disabling SD encryption on the device. |
prv_sdcard | Whether the lockdown policy for the device has disabled access to the SD card. | ON – Access to the SD card is enabled. OFF – Access to the SD card is disabled. unsupported – A lockdown policy is not applied to this device. |
prv_vpn_servers | A list of VPN servers that the device can access. | List of semi-colon-separated VPN servers, each given as an IP address, a host name, or a URL. The value is na if the list is empty. |
prv_wifi | Whether the lockdown policy for the device has disabled access to wireless LANs. | ON – Access to wireless LANs is enabled. OFF – Access to wireless LANs is disabled. unsupported – The Ivanti EPMM client does not support enabling or disabling access to wireless LANs on the device. |
prv_wlan_ssids | Wireless local area network Service Set Identifiers for all wireless LANs configures on the device. | List of identifiers, separated by semi-colons. If none, then the value is na. Example: Ivanti-Guest;Ivanti-Test |
registration_imsi | International Mobile Subscriber Identity number for the device. | Example: 262073991646313 |
registration_operator_name | The name of the service provider for the device. | Example: Verizon |
regUuid | Device’s unique ID. | Example: ddc865b69c13eeb4 |
Samsung_DM | Samsung device information for Samsung devices that support Samsung MDM APIs. | Example: FW: Key2,1 SW:1.0 |
security_state | Indicates whether the device has been compromised. A compromised Android device means that the device has been rooted, which means that an application has root access to the device’s file system. | Ok – The device has not been compromised. Compromised – The device has been compromised. |
SIM_module_number | International Mobile Subscriber Identity number for the device. | Example: IMSI:3104105000000000 |
system_id | CDMA System Identification number | Example: 40 |
total_media_card_size | Amount of storage on the media card on the device. | Number of megabytes, shown with M suffix. Example: 7574.19M |
total_media_card_size_bytes | Amount of storage on the media card on the device. | Number in bytes Example: 785037745 |
total_ram_size | Amount of RAM memory on the device. | Number of megabytes, shown with M suffix. Example: 475.93M |
total_ram_size_bytes | Amount of RAM memory on the device. | Number in bytes Example: 504857000 |
total_storage_size | Amount of storage on the device. | Number of megabytes, shown with M suffix. Example: 6700.98M |
total_storage_size_bytes | Amount of storage on the device. | Number in bytes Example: 104857000 |
usb_debugging | Indicates whether USB debugging is enabled on the device. | ON – USB debugging is enabled. OFF – USB debugging is disabled. |
wifi_mac_addr | Wi-Fi MAC address of the device. | Example: f87b7a29838f |