Contents

MachineInfo

A device’s information in response to a MDM enrollment profile request.

Declaration

object MachineInfo

Properties

NameTypeDescription
IMEIstring

The device’s IMEI (if available).

LANGUAGEstring

The user’s currently-selected language, for example, en.

MANDATORY_SOFTWARE_UPDATE_REQUIREDboolean

If true, indicates that the device requires a mandatory software update during Setup Assistant. The MDM server can return a 403 with a ErrorCodeSoftwareUpdateRequired error to force the device to update to a specific version instead of the device choosing a version.

Available on macOS 26.1 and later.

MDM_CAN_REQUEST_PSSO_CONFIGboolean

If true, indicates that the server can trigger the device to do a required Platform SSO authentication before enrolling.

Available on macOS 26 and later.

MDM_CAN_REQUEST_SOFTWARE_UPDATEboolean

If true, indicates that the server can trigger the device to do a required software update.

Available on iOS 17 and later, and macOS 14 and later.

MEIDstring

The device’s MEID (if available).

OS_VERSION Requiredstring

The OS version installed on the device, for example, 17.0.

Available on iOS 17 and later, macOS 14 and later, tvOS 17 and later, and watchOS 10 and later.

PAIRING_TOKENdata

The pairing token to validate when a watch is enrolling.

Available on watchOS 10 and later.

PRODUCT Requiredstring

The device’s product type, for example, iPhone5,1.

SERIAL Requiredstring

The device’s serial number.

SOFTWARE_UPDATE_DEVICE_IDstring

The device model identifier used to lookup available OS updates through https://gdmf.apple.com/v2/pmv. Available on iOS 17.4 and later, macOS 14.4 and later, and visionOS 1.1 and later.

SUPPLEMENTAL_BUILD_VERSIONstring

The device’s operating system supplemental build version (if available).

Available on iOS 17 and later, macOS 14 and later, tvOS 17 and later, and watchOS 10 and later.

SUPPLEMENTAL_OS_VERSION_EXTRAstring

The device’s operating system supplemental OS version extra (if available).

Available on iOS 17 and later, macOS 14 and later, tvOS 17 and later, and watchOS 10 and later.

UDID Requiredstring

The device’s UDID.

VERSION Requiredstring

The build version installed on the device, for example, 7A182.

Mentioned in

Discussion

This dictionary is CMS-signed with the device identity certificate. The system includes the device’s certificate and all necessary intermediate certificates. The certificate chain should validate against the Apple Root CA.

See Also

Objects and Data Types