<!--
{
  "availability" : [
    "iOS: 5.0.0 -",
    "iPadOS: 5.0.0 -",
    "macCatalyst: 5.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeviceManagement",
  "identifier" : "/documentation/DeviceManagement/Apply-Redemption-Code-Command",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Device Management"
    ],
    "preciseIdentifier" : "rest:put:mdm#ApplyRedemptionCodeCommand"
  },
  "title" : "Apply Redemption Code"
}
-->

# Apply Redemption Code

Complete the installation of an app using a redemption code.

## Discussion

This command provides a redemption code to complete installing an app. Use this when `InstallApplication` returns `NeedsRedemption`, or when `ManagedApplicationList` returns `NeedsRedemption` for the status of the app.

Sending a redemption code to an app that doesn’t need it produces an error.

Refer to the following sections to determine supported channels and requirements, and to see an example request and response.

### Command availability

|||
|--------------------------|--------------------|
|Device channel            |iOS                 |
|User channel              |N/A                 |
|Requires supervision      |N/A                 |
|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>Identifier</key>
        <string>com.example.app</string>
        <key>RedemptionCode</key>
        <string>SB56LT7YX8RH</string>
        <key>RequestType</key>
        <string>ApplyRedemptionCode</string>
    </dict>
    <key>CommandUUID</key>
    <string>0001_ApplyRedemptionCode</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>CommandUUID</key>
    <string>0001_ApplyRedemptionCode</string>
    <key>Status</key>
    <string>Acknowledged</string>
    <key>UDID</key>
    <string>00008020-001305842600013A</string>
</dict>
</plist>
```

## Topics

### Commands and responses

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

The command to complete the installation of an app using a redemption code.

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

A response from the device after it processes the command to complete the installation of an app using a redemption code.



---

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)