Contents

DeviceInformationResponse.QueryResponses

The response dictionary that contains information about the device.

Declaration

object DeviceInformationResponse.QueryResponses

Properties

NameTypeDescription
AccessibilitySettingsDeviceInformationResponse.QueryResponses.AccessibilitySettings

The current state of settable accessibility settings. Available in iOS 16 and later.

ActiveManagedUsers[string]

An array of the directory GUIDs of the logged-in managed users. If one of these users is currently logged in to the console, the CurrentConsoleManagedUser key returns the GUID of that user. Requires the Device Information access right. Available in macOS 10.11 and later.

AppAnalyticsEnabledboolean

If true, the device is sharing app analytics. Requires the Device Information access right. Available in iOS 9.3 and later.

AutoSetupAdminAccounts[DeviceInformationResponse.QueryResponses.AutoSetupAdminAccountsItem]

The contents of DeviceInformationResponse.QueryResponses.AutoSetupAdminAccountsItem, which Setup Assistant automatically creates during DEP enrollment. Requires the Device Information access right. Available in macOS 10.11 and later.

AvailableDeviceCapacitynumber

The available capacity in floating-point base-10 gigabytes (GB) in iOS and macOS 12 or later. The capacity is in base-2 gibibytes (GiB) in macOS 11 and earlier. Requires the Device Information access right. Available in iOS 4 and later, and macOS 10.7 and later.

AwaitingConfigurationboolean

If true on the device channel, the device is still waiting for a Device Configured command to continue through Setup Assistant.

If true on the user channel (Shared iPad only), the device is still waiting for a User Configured command to continue through Setup Assistant and finish login.

BatteryLevelnumber

The battery level, between 0.0 and 1.0, or -1.0 if MDM can’t determine the battery level. Requires the Device Information access right. Available in iOS 5 and later, and macOS 13.3 and later.

BluetoothMACstring

The Bluetooth media access control (MAC) address. Requires the Network Information access right.

BuildVersionstring

The operating system version. Requires the Device Information access right.

CellularTechnologyinteger

The cellular technology type, which is one of the following values:

  • 0: None

  • 1: GSM

  • 2: CDMA

  • 3: GSM and CDMA

Requires the Device Information access right. Available in iOS 4.2.6 and later.

DataRoamingEnabledboolean

If true, the device has enabled data roaming. Requires the Network Information access right. Available in iOS 5 and later.

DeviceCapacitynumber

The total capacity in floating-point base-10 gigabytes (GB) on iOS and macOS 12 or later. The capacity is in base-2 gibibytes (GiB) on macOS 11 and earlier. Requires the Device Information access right. Available in iOS 4 and later, and macOS 10.7 and later.

DeviceIDstring

The device identifier. Requires the Device Information access right. Available in tvOS 6 and later.

DeviceNamestring

The device name. Requires the Device Information access right.

DevicePropertiesAttestation[data]

The key to get an attestation of the device’s properties. Available in iOS 16 and later, macOS 14 and later, tvOS 16 and later, and watchOS 10 and later. The hardware requirements for attestation are described below.

The value is an array of certificates in DER form that forms a certificate chain. The chain is rooted with the Apple CA Apple Enterprise Attestation Root CA. The first array item is the leaf certificate. The leaf certificate contains custom OIDs describing a device. The OS version of the device, and the type of enrollment, determine which OIDs are present in the certificate. If Apple’s attestation servers are unable to verify a device property they generate a blank value, omit the OID entirely, or refuse to issue an attestation certificate.

The following OIDs were introduced in iOS 16, iPadOS 16, tvOS 16, watchOS 10, visionOS 1 and macOS 14:

  • 1.2.840.113635.100.8.9.1 serial number: This is the serial number of the device. It is omitted if the enrollment is a user enrollment.

  • 1.2.840.113635.100.8.9.2 UDID: For a Mac this has the same value as the ProvisioningUDID key, and does not match the UDID used elsewhere in the MDM protocol. It is omitted if the enrollment is a user enrollment.

  • 1.2.840.113635.100.8.10.2 sepOS version: This is the version of the operating system running on the Secure Enclave when the attestation is generated. Typically this matches the version of the main operating system.

  • 1.2.840.113635.100.8.11.1 Freshness code: This is the freshness code. See the DeviceAttestationNonce. This may not match the requested freshness code if a cached attestation was returned.

The following OIDs were introduced in iOS 17.2, iPadOS 17.2, tvOS 17.2, watchOS 10.2, visionOS 1.l0, and macOS 14.2:

  • 1.2.840.113635.100.8.9.4 Software Update Device ID: This is an identifier of the device model. It is expected to match the SoftwareUpdateDeviceID in the `DeviceInformation`` response. This is the device identifier to use when looking up available OS updates through https://gdmf.apple.com/v2/pmv.

  • 1.2.840.113635.100.8.10.1 OS Version: This is the version of iOS, iPadOS or tvOS running on the device when the attestation is generated.

  • 1.2.840.113635.100.8.10.3 LLB Version: This is the version of the Low Level Bootloader firmware running on the device when the attestation is generated. For more information about the boot process, see the documentation of the boot process in the Apple Platform Security guide.

The following OIDs were introduced in macOS 14.2:

  • 1.2.840.113635.100.8.13.1 System Integrity Protection (SIP) status: This indicates whether SIP is enabled or disabled when the attestation is generated. 0 indicates enabled, 1 indicates disabled.

  • 1.2.840.113635.100.8.13.2 Secure boot status: This describes part of the configuration of the LocalPolicy when the attestation is generated. The values are Full Security, Reduced Security, or Permissive Security. For a description of these values see the Apple Platform Security guide.

  • 1.2.840.113635.100.8.13.3 Third party kernel extensions allowed: This indicates whether third party kernel extensions are allowed. A value of 0 indicates third party kernel extensions are not allowed. Any other value means that some kinds of third party kernel extensions are allowed.

DiagnosticSubmissionEnabledboolean

If true, the device has enabled diagnostic submission. Requires the Device Information access right. Available in iOS 9.3 and later.

EACSPreflightstring

Specifies whether the device can perform an EraseDeviceCommand using Erase All Content and Settings (EACS), which is one of the following values:

success

The device supports EACS.

not supported

The device is too old to support EACS.

unknown failure

A problem occurred for which there isn’t a more specific error message.

(other string)

A reason why the device can’t perform EACS, such as “System is not sealed”

EASDeviceIdentifierstring

The device identifier for Exchange Active Sync (EAS). Requires the Device Information access right. Available in iOS 7 and later.

EstimatedResidentUsersinteger

The estimated number of users that can use this Shared iPad device, according to the space available on the device and each user’s quota. Requires the Device Information access right. Available in iOS 14 and later.

EthernetMACstring

The primary Ethernet MAC address. Requires the Network Information access right. Available in macOS 10.7 and later.

HasBatteryboolean

If true, the device has an internal battery.

HostNamestring

The host name. Available in macOS 10.11 and later.

IsActivationLockEnabledboolean

If true, the device has enabled Activation Lock. Requires the Device Information access right. Available as of iOS 7 and macOS 10.9, and deprecated in iOS 16 and macOS 13.

IsActivationLockSupportedboolean

If true, the device supports Activation Lock. Also see IsActivationLockManageable in SecurityInfoResponse.SecurityInfo.ManagementStatus. Available in macOS 10.9 and later.

IsAppleSiliconboolean

If true, the macOS device uses an Apple silicon chip.

IsCloudBackupEnabledboolean

If true, the device has enabled iCloud backup. Requires the Device Information access right. Available in iOS 7.1 and later.

IsDeviceLocatorServiceEnabledboolean

If true, the device has enabled a device locator service, such as Find My. Requires the Device Information access right. Available in iOS 7 and later.

IsDoNotDisturbInEffectboolean

If true, the device is in Do Not Disturb (DND) mode. This value is true even if DND is only in effect for a locked device. Requires the Device Information access right. Available in iOS 7 and later.

IsMDMLostModeEnabledboolean

If true, the device has enabled Managed Lost Mode. Requires the Device Information access right. Available in iOS 9.3 and later.

IsMultiUserboolean

If true, the device is a Shared iPad. Requires the Device Information access right. Available in iOS 9.3 and later.

IsNetworkTetheredboolean

If true, the device is network-tethered. Requires the Network Information access right. Available in iOS 10.3 and later.

IsSupervisedboolean

If true, it’s a supervised device. Requires the Device Information access right. Available in iOS 6 and later, macOS 10.15 and later, and tvOS 9 and later.

iTunesStoreAccountHashstring

A hash of the logged-in iTunes Store account. Also see GetVppUserRequest. Requires the App Installation access right.

iTunesStoreAccountIsActiveboolean

If true, the device has an active iTunes Store account. Requires the App Installation access right.

LastCloudBackupDatedate

The date of the last iCloud backup. Available in iOS 8 and later.

LocalHostNamestring

The local host name from Bonjour. Available in macOS 10.11 and later.

ManagedAppleIDDefaultDomains[string]

The list of domains that the device suggests on the Shared iPad login screen. Available in iOS 16 and later.

MaximumResidentUsersinteger

The maximum number of users that can use this Shared iPad device. Starting with iOS 13.4, the value that returns is always 32. Requires the Device Information access right. Available in iOS 9.3 and later.

MDMOptionsDeviceInformationResponse.QueryResponses.MDMOptions

The contents of SettingsCommand.Command.Settings.MDMOptions.MDMOptions.

Modelstring

The model. Requires the Device Information access right.

ModelNamestring

The model name, such as iPhone. Requires the Device Information access right.

ModelNumberstring

The device’s hardware model number including region info, for example, MK1A3LL/A. Requires the Device Information access right. Requires a Mac with Apple silicon on macOS.

ModemFirmwareVersionstring

The modem firmware version. Requires the Device Information access right. Available in iOS 4 and later.

OnlineAuthenticationGracePeriodinteger

The grace period for Shared iPad online authentication (in days). A value of 0 indicates that the device requires online authentication for every login. Available in iOS 16 and later.

OrganizationInfoDeviceInformationResponse.QueryResponses.OrganizationInfo

The contents of SettingsCommand.Command.Settings.OrganizationInfo.OrganizationInfo.

OSUpdateSettingsDeviceInformationResponse.QueryResponses.OSUpdateSettings

The contents of DeviceInformationResponse.QueryResponses.OSUpdateSettings. Requires the Device Information access right. Available in macOS 10.11 and later.

OSVersionstring

The operating system version. Requires the Device Information access right.

PersonalHotspotEnabledboolean

If true, the device has enabled Personal Hotspot, which isn’t available for all carriers. Requires the Network Information access right. Available in iOS 7 and later.

PINRequiredForDeviceLockboolean

If true, the DeviceLockCommand requires a PIN. Available in macOS 11 and later.

PINRequiredForEraseDeviceboolean

If true, the EraseDeviceCommand requires a PIN. Available in macOS 11 and later.

ProductNamestring

The product name, such as iPad8,12. Requires the Device Information access right.

ProvisioningUDIDstring

The device identifier to use in provisioning profiles. This value differs from the UDID on a Mac with Apple silicon. Available in macOS 11.3 and later.

PushTokendata

The push token for the user-channel connection, in the same format as in TokenUpdateRequest. MDM ignores this query for the device channel. Requires the Device Information access right. Available in iOS 9.3 and later, and macOS 10.12 and later.

QuotaSizeinteger

The quota size in megabytes for each user on this Shared iPad device. Requires the Device Information access right. Available in iOS 13.4 and later.

ResidentUsersinteger

The number of users currently on this Shared iPad device. Requires the Device Information access right. Available in iOS 13.4 and later.

SerialNumberstring

The serial number. Requires the Device Information access right.

ServiceSubscriptions[DeviceInformationResponse.QueryResponses.ServiceSubscriptionProperty]

The contents of DeviceInformationResponse.QueryResponses.ServiceSubscriptionProperty. Requires the Network Information access right.

SkipLanguageAndLocaleSetupForNewUsersboolean

If true, skip the language and country/region panes for new users on Shared iPad.

SoftwareUpdateDeviceIDstring

The device identifier to look up available OS updates through https://gdmf.apple.com/v2/pmv. Available in iOS 15 and later, and macOS 12 and later.

SoftwareUpdateSettingsDeviceInformationResponse.QueryResponses.SoftwareUpdateSettings

The device settings that control which updates appear in the Software Update pane in Settings. Available in iOS 14.5 and later.

SupplementalBuildVersionstring

The supplemental OS build version.

SupplementalOSVersionExtrastring

The OS update Background Security Improvement version letter.

SupportsiOSAppInstallsboolean

If true, the device supports iOS or iPadOS app installs through MDM. Available in macOS 11 and later.

SupportsLOMDeviceboolean

If true, the device can receive PowerON, PowerOFF, and Reset commands from a lights-out management (LOM) controller. Available in macOS 11 and later.

SystemIntegrityProtectionEnabledboolean

If true, the device has enabled System Integrity Protection. Requires the Device Information access right. Available in macOS 10.12 and later.

TemporarySessionOnlyboolean

If true, the device allows only temporary sessions.

TemporarySessionTimeoutinteger

The timeout interval for the temporary session. A value of 0 indicates that there’s no timeout.

TimeZonestring

The current Internet Assigned Numbers Authority (IANA) time zone database name. Requires the Device Information access right. Available in iOS 14 and later, and tvOS 14 and later.

UDIDstring

The unique identifier of the device.

UserSessionTimeoutinteger

The timeout interval for the user session. A value of 0 indicates that there’s no timeout.

WiFiMACstring

The Wi-Fi MAC address. Requires the Network Information access right.

Topics

Objects

See Also

Objects