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 |
|---|---|---|
AppleCare log collection status | iOS 27 iPadOS 27 macOS 27 tvOS 27 | Whether a log collection has been started, finished, or canceled, whether the device is waiting for user consent, and if an upload is in progress. |
AppleCare log collection timestamp | iOS 27 iPadOS 27 macOS 27 tvOS 27 | The timestamp of the last status change. |
AppleCare log collection token | iOS 27 iPadOS 27 macOS 27 tvOS 27 | The provided AppleCare token. |
Awaiting configuration | iOS 27 iPadOS 27 macOS 27 tvOS 27 visionOS 27 watchOS 27 | Indicates whether the device is waiting in Setup Assistant for the device management service. |
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. |
Content caching info | macOS 27 | General information about the content cache, such as available and used storage space, status, and cache pressure. |
Content caching parents | macOS 27 | The list and status of parent content caches. |
Content caching peers | macOS 27 | The list and status of peer content caches. |
Content caching status | macOS 27 | More detailed information about the registration status, IP addresses, report status, and encountered errors. |
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. |
Enrollment type | iOS 27 iPadOS 27 macOS 27 tvOS 27 visionOS 27 watchOS 27 | Whether the enrollment is a user enrollment, device enrollment, or a supervised enrollment. |
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. |
Installed packages | macOS 26 | A list of packages and their status 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. |
Lockdown Mode | iOS 27 iPadOS 27 macOS 27 watchOS 27 | Whether or not Lockdown Mode is turned on. |
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. |
Managed apps | iOS 17.2 iPadOS 17.2 macOS 26 visionOS 2.4 | A list of managed apps. |
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). |
Migration Assistant report | macOS 26.4 | Date, time, amount of data transferred, and if any files could not be migrated. |
Migration Assistant status | macOS 26.4 | The device's current migration state. |
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. |
Push magic and push token | iOS 27 iPadOS 27 macOS 27 tvOS 27 visionOS 27 watchOS 27 | Details related to the Apple Push Notification service (APNs) properties required for device management. |
Return to Service | iOS 27 iPadOS 27 visionOS 27 | Indicates whether the device is configured for Return to Service with app preservation. |
Shared iPad | iPadOS 27 | Indicates whether the device is configured as Shared iPad. |
Software update | iOS 17 iPadOS 17 macOS 14 visionOS 26 | 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. |
System health | iOS 27 iPadOS 27 | Insights into the status and genuineness of hardware components like baseband, camera, Face ID, Touch ID, NFC, and Ultra-Wideband. |
Note: Not all configurations and their settings are available in all device management services. Each device management service developer implements these settings differently. To learn which settings are available for your devices, consult your developer’s device management service documentation.