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: iOS 16+ | iPadOS 16+ | watchOS 10+

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: macOS 10.11+

AppAnalyticsEnabledboolean

If true, the device is sharing app analytics. Requires the Device Information access right.

Available: iOS 9.3+ | iPadOS 9.3+ | visionOS 1.1+ | watchOS 10+

AutoSetupAdminAccounts[DeviceInformationResponse.QueryResponses.AutoSetupAdminAccountsItem]

The contents of DeviceInformationResponse.QueryResponses.AutoSetupAdminAccountsItem, which Setup Assistant automatically creates during ADE enrollment. Requires the Device Information access right.

Available: macOS 10.11+

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: iOS 4+ | iPadOS 4+ | macOS 10.7+ | visionOS 1.1+ | watchOS 10+

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.

Available: iOS 9+ | iPadOS 9+ | macOS 10.11+ | tvOS 10.2+ | visionOS 2+ | watchOS 10+

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: iOS 5+ | iPadOS 5+ | macOS 13.3+ | visionOS 1.1+ | watchOS 10+

BluetoothMACstring

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

Available: iOS 4+ | iPadOS 4+ | macOS 10.7+ | tvOS 9+ | visionOS 1.1+

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: iOS 4.2.6+ | iPadOS 4.2.6+

DataRoamingEnabledboolean

If true, the device has enabled data roaming. Requires the Network Information access right.

Available: iOS 5+ | iPadOS 5+

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: iOS 4+ | iPadOS 4+ | macOS 10.7+ | visionOS 1.1+ | watchOS 10+

DeviceIDstring

The device identifier. Requires the Device Information access right.

Available: tvOS 9+

DeviceNamestring

The device name. Requires the Device Information access right.

DevicePropertiesAttestation[data]

The key to get an attestation of the device’s properties. 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.

Available: iOS 16+ | iPadOS 16+ | macOS 14+ | tvOS 16+ | visionOS 1.1+ | watchOS 10+

DiagnosticSubmissionEnabledboolean

If true, the device has enabled diagnostic submission. Requires the Device Information access right.

Available: iOS 9.3+ | iPadOS 9.3+ | visionOS 1.1+ | watchOS 10+

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”

Available: macOS 13.3+

EASDeviceIdentifierstring

The device identifier for Exchange Active Sync (EAS). Requires the Device Information access right.

Available: iOS 7+ | iPadOS 7+ | visionOS 1.1+

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: iOS 14+ | iPadOS 14+

EthernetMACstring

The primary Ethernet MAC address. Requires the Network Information access right.

Available: macOS 10.7+

HasBatteryboolean

If true, the device has an internal battery.

Available: macOS 13.3+

HostNamestring

The host name.

Available: macOS 10.11+

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.

Available: iOS 7+ | iPadOS 7+ | macOS 10.9+ | watchOS 10+ Deprecated: iOS 16+ | iPadOS 16+ | macOS 13+ | watchOS 10+

IsActivationLockSupportedboolean

If true, the device supports Activation Lock. Also see IsActivationLockManageable in SecurityInfoResponse.SecurityInfo.ManagementStatus.

Available: macOS 10.9+

IsAppleSiliconboolean

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

Available: macOS 12+

IsCloudBackupEnabledboolean

If true, the device has enabled iCloud backup. Requires the Device Information access right.

Available: iOS 7.1+ | iPadOS 7.1+ | visionOS 1.1+

IsDeviceLocatorServiceEnabledboolean

If true, the device has enabled a device locator service, such as Find My. Requires the Device Information access right.

Available: iOS 7+ | iPadOS 7+ | visionOS 1.1+ | watchOS 10+

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: iOS 7+ | iPadOS 7+ | visionOS 1.1+ | watchOS 10+

IsMDMLostModeEnabledboolean

If true, the device has enabled Managed Lost Mode. Requires the Device Information access right.

Available: iOS 9.3+ | iPadOS 9.3+ | watchOS 10+

IsMultiUserboolean

If true, the device is a Shared iPad. Requires the Device Information access right.

Available: iOS 9.3+ | iPadOS 9.3+

IsNetworkTetheredboolean

If true, the device is network-tethered. Requires the Network Information access right.

Available: iOS 10.3+ | iPadOS 10.3+

IsSupervisedboolean

If true, it’s a supervised device. Requires the Device Information access right.

Available: iOS 6+ | iPadOS 6+ | macOS 10.15+ | tvOS 9+ | visionOS 1.1+ | watchOS 10+

iTunesStoreAccountHashstring

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

Available: iOS 8+ | iPadOS 8+ | macOS 10.10+ | tvOS 9+ | watchOS 10+

iTunesStoreAccountIsActiveboolean

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

Available: iOS 7+ | iPadOS 7+ | macOS 10.9+ | tvOS 9+ | watchOS 10+

LastCloudBackupDatedate

The date of the last iCloud backup.

Available: iOS 8+ | iPadOS 8+ | visionOS 1.1+

LocalHostNamestring

The local host name from Bonjour.

Available: macOS 10.11+

ManagedAppleIDDefaultDomains[string]

The list of domains that the device suggests on the Shared iPad login screen.

Available: iOS 16+ | iPadOS 16+

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: iOS 9.3+ | iPadOS 9.3+

MDMOptionsDeviceInformationResponse.QueryResponses.MDMOptions

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

Available: iOS 7+ | iPadOS 7+ | macOS 11+ | tvOS 9+ | visionOS 1.1+ | watchOS 10+

Modelstring

The model. Requires the Device Information access right.

Available: iOS 4+ | iPadOS 4+ | macOS 10.7+ | tvOS 9+ | watchOS 10+

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: iOS 4+ | iPadOS 4+

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: iOS 16+ | iPadOS 16+

OrganizationInfoDeviceInformationResponse.QueryResponses.OrganizationInfo

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

Available: iOS 7+ | iPadOS 7+ | macOS 10.11+ | tvOS 9+ | visionOS 1.1+ | watchOS 10+

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: iOS 7+ | iPadOS 7+

PINRequiredForDeviceLockboolean

If true, the DeviceLockCommand requires a PIN.

Available: macOS 11+

PINRequiredForEraseDeviceboolean

If true, the EraseDeviceCommand requires a PIN.

Available: macOS 11+

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: macOS 11.3+

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: iOS 9.3+ | iPadOS 9.3+ | macOS 10.12+

QuotaSizeinteger

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

Available: iOS 13.4+ | iPadOS 13.4+

ResidentUsersinteger

The number of users currently on this Shared iPad device. Requires the Device Information access right.

Available: iOS 13.4+ | iPadOS 13.4+

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.

Available: iOS 12+ | iPadOS 12+

SkipLanguageAndLocaleSetupForNewUsersboolean

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

Available: iOS 16.2+ | iPadOS 16.2+

SupplementalBuildVersionstring

The supplemental OS build version.

Available: iOS 16.1+ | iPadOS 16.1+ | macOS 13+ | tvOS 16.1+ | visionOS 1.1+ | watchOS 10+

SupplementalOSVersionExtrastring

The OS update Background Security Improvement version letter.

Available: iOS 16.1+ | iPadOS 16.1+ | macOS 13+ | tvOS 16.1+ | visionOS 1.1+ | watchOS 10+

SupportsiOSAppInstallsboolean

If true, the device supports iOS or iPadOS app installs through MDM.

Available: macOS 11+

SupportsLOMDeviceboolean

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

Available: macOS 11+

SystemIntegrityProtectionEnabledboolean

If true, the device has enabled System Integrity Protection. Requires the Device Information access right.

Available: macOS 10.12+

TemporarySessionOnlyboolean

If true, the device allows only temporary sessions.

Available: iOS 14.5+ | iPadOS 14.5+

TemporarySessionTimeoutinteger

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

Available: iOS 14.5+ | iPadOS 14.5+

TimeZonestring

The current Internet Assigned Numbers Authority (IANA) time zone database name. Requires the Device Information access right.

Available: iOS 14+ | iPadOS 14+ | tvOS 14+ | visionOS 1.1+ | watchOS 10+

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.

Available: iOS 14.5+ | iPadOS 14.5+

WiFiMACstring

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

Topics

Objects

See Also

Objects