<!--
{
  "availability" : [
    "iOS: 9.0.0 - 26.0.0",
    "iPadOS: 9.0.0 - 26.0.0",
    "macCatalyst: 9.0.0 - 26.0.0",
    "macOS: 10.11.0 - 26.0.0",
    "tvOS: 12.0.0 - 26.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "DeviceManagement",
  "identifier" : "/documentation/DeviceManagement/Available-OS-Updates-Command",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Device Management"
    ],
    "preciseIdentifier" : "rest:put:mdm#AvailableOSUpdatesCommand"
  },
  "title" : "Available OS Updates"
}
-->

# Available OS Updates

Get a list of available operating-system updates for a device. Removed: use the declarative management `com.apple.configuration.softwareupdate.enforcement.specific` configuration.

## Discussion

A device must have a total of `DownloadSize` + `InstallSize` bytes available to successfully install a software update. In macOS, execute the `ScheduleOSUpdateScan` command to update the results that this command returns. In iOS and tvOS, the list only contains the latest available updates.

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
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Command</key>
    <dict>
        <key>RequestType</key>
        <string>AvailableOSUpdates</string>
    </dict>
    <key>CommandUUID</key>
    <string>0001_AvailableOSUpdates</string>
</dict>
</plist>
```

**Response:**

```plist
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>AvailableOSUpdates</key>
    <array>
        <dict>
            <key>AllowsInstallLater</key>
            <false/>
            <key>Build</key>
            <string>17A576</string>
            <key>DownloadSize</key>
            <integer>251607570</integer>
            <key>HumanReadableName</key>
            <string>iOS 13.0</string>
            <key>InstallSize</key>
            <integer>1809842176</integer>
            <key>IsCritical</key>
            <false/>
            <key>ProductKey</key>
            <string>iOSUpdate17A576</string>
            <key>ProductName</key>
            <string>iOS</string>
            <key>RestartRequired</key>
            <true/>
            <key>Version</key>
            <string>13.0</string>
        </dict>
    </array>
    <key>CommandUUID</key>
    <string>0001_AvailableOSUpdates</string>
    <key>Status</key>
    <string>Acknowledged</string>
    <key>UDID</key>
    <string>00008020-000915083C80012E</string>
</dict>
</plist>
```

## Topics

### Commands and responses

[`AvailableOSUpdatesCommand`](/documentation/DeviceManagement/AvailableOSUpdatesCommand)

The command to get a list of available operating-system updates for a device. Removed: use the declarative management `com.apple.configuration.softwareupdate.enforcement.specific` configuration.

[`AvailableOSUpdatesResponse`](/documentation/DeviceManagement/AvailableOSUpdatesResponse)

A response from the device after it processes the command to get a list of available operating-system updates for a device. Removed: use the declarative management `com.apple.configuration.softwareupdate.enforcement.specific` configuration.



---

Copyright &copy; 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)