# OS Update Status Get the status of operating-system updates on a device. Removed: subscribe to the declarative management `softwareupdate.install-state` status item. ## Discussion Refer to the following sections to determine supported channels and requirements, and to see an example request and response. ### Command availability ||| |--------------------------|-----------------------------| |Device channel |iOS, macOS, Shared iPad, tvOS| |User channel |N/A | |Requires supervision |iOS, macOS, tvOS | |Allowed in user enrollment|N/A | |Required access right |AllowAppInstallation | ### Example request and response **Request:** ```plist Command RequestType OSUpdateStatus CommandUUID 0001_OSUpdateStatus ``` **Response:** ```plist CommandUUID 0001_OSUpdateStatus OSUpdateStatus DownloadPercentComplete 0.5030184984207153 IsDownloaded ProductKey iOSUpdate17A576 Status Downloading Status Acknowledged UDID 00008020-000915083C80012E ``` ## Topics ### Commands and responses [`OSUpdateStatusCommand`](/documentation/DeviceManagement/OSUpdateStatusCommand) The command to get the status of operating-system updates on a device. Removed: subscribe to the declarative management `softwareupdate.install-state` status item. [`OSUpdateStatusResponse`](/documentation/DeviceManagement/OSUpdateStatusResponse) A response from the device after it processes the command to get the status of operating-system updates on a device. Removed: subscribe to the declarative management `softwareupdate.install-state` status item. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)