Declarative status reports for Apple devices
Device status reports return information about a device’s current state. When a device management service subscribes to status objects, it receives reports about any changes. Status reports can return the values in the following tables for information related to the device, accounts, passcode, or apps that install with a device management service.
These status reports can be used for User Enrollment, Device Enrollment, and Automated Device Enrollment.
Status object | Minimum supported operating system versions and channels | Value returned |
|---|---|---|
Background tasks | macOS 14 | A list and details of launch agents, launch daemons, and background tasks including details such as type, state, bundle ID, UID, label, and team identifier. |
Battery health | iOS 17 macOS 14.4 | The status of the battery on an iPhone or on a Mac with Apple silicon. |
Calendar (CalDAV) account list | iOS 16 iPadOS 16.1 Shared iPad (user channel) macOS 13 (user channel) visionOS 1.1 | A list of CalDAV accounts. |
Contacts (CardDAV) account list | iOS 16 iPadOS 16.1 Shared iPad (user channel) macOS 13 (user channel) visionOS 1.1 | A list of CardDAV accounts. |
Device Model Family | iOS 15 iPadOS 15 macOS 13 tvOS 16 visionOS 1.1 | Hardware model of the device, such as iPhone, iPad, Mac, or Apple TV. |
Device Model Identifier | iOS 15 iPadOS 15 macOS 13 tvOS 16 visionOS 1.1 | Device’s hardware identifier, including the device’s model family and version. The model’s version is a comma-separated number, where the first part of the number is the version, and the second part is a variant, such as MacBookPro15,1 or iPhone13,2. |
Device Model Marketing Name | iOS 15 iPadOS 15 macOS 13 tvOS 16 visionOS 1.1 | Device’s marketing name, such as iPhone 13. |
Device Operating System Build Version | iOS 15 iPadOS 15 macOS 13 tvOS 16 visionOS 1.1 | Operating system software build identifier, such as 18F132. |
Device Operating System Family | iOS 15 iPadOS 15 macOS 13 tvOS 16 visionOS 1.1 | Operating system family, such as iOS, iPadOS, macOS, or tvOS |
Device Operating System Marketing Name | iOS 15 iPadOS 15 macOS 13 tvOS 16 visionOS 1.1 | Operating system marketing name, such as macOS Ventura. |
Device Operating System Supplemental Build Version | iOS 26.2 iPadOS 26.2 macOS 26.2 tvOS 26.2 visionOS 26.2 | Background Security Improvement build version, such as 22A771000a. |
Device Operating System Supplemental Extra Version | iOS 26.2 iPadOS 26.2 macOS 26.2 tvOS 26.2 visionOS 26.2 | Background Security Improvement extra version, such as “(a)”, “(b)”, or “(c)”. |
Device Operating System Version | iOS 15 iPadOS 15 macOS 13 tvOS 16 visionOS 1.1 | Operating system version, such as iOS 15.4 |
Device Serial Number | iOS 15 iPadOS 15 macOS 13 tvOS 16 visionOS 1.1 | Device serial number, such as X0XX234XYXYX. |
Device UDID | iOS 15 iPadOS 15 macOS 13 tvOS 16 visionOS 1.1 | Device UDID, such as 2E2A61F5-9BBE-42D9-A199-167EA246B044. |
FileVault status | macOS 14 | Whether FileVault is turned on. |
Google account list | iOS 16 iPadOS 16.1 Shared iPad (user channel) macOS 13 (user channel) visionOS 1.1 | A list of Google accounts |
Installed apps | iOS 16 iPadOS 16.1 tvOS 16 visionOS 1.1 | A list of apps that install with a device management service. |
LDAP account list | iOS 16 iPadOS 16.1 Shared iPad (user channel) macOS 13 (user channel) visionOS 1.1 | A list of LDAP accounts. |
Mail (incoming) account list | iOS 16 iPadOS 16.1 Shared iPad (user channel) macOS 13 (user channel) visionOS 1.1 | A list of incoming mail accounts. |
Mail (outgoing) account list | iOS 16 iPadOS 16.1 Shared iPad (user channel) macOS 13 (user channel) visionOS 1.1 | A list of outgoing mail accounts. |
Microsoft Exchange account list | iOS 16 iPadOS 16.1 Shared iPad (user channel) macOS 13 (user channel) visionOS 1.1 | A list of Exchange accounts. Includes both Exchange ActiveSync (EAS) and Exchange Web Services (EWS). |
Passcode Compliance | iOS 16 iPadOS 16.1 visionOS 1.1 | The state of passcode compliance. |
Passcode Is Present | iOS 16 iPadOS 16.1 visionOS 1.1 | The status of a passcode on the device. |
Software update | iOS 17 iPadOS 17 macOS 14 | Status and, if failed, error reasons of a current software update. |
Subscribed calendar list | iOS 16 iPadOS 16.1 Shared iPad (user channel) macOS 13 (user channel) visionOS 1.1 | A list of subscribed calendar accounts. |