<!--
{
  "availability" : [
    "iOS: 17.2.0 -",
    "iPadOS: 17.2.0 -",
    "macCatalyst: 17.2.0 -",
    "macOS: 26.0.0 -",
    "visionOS: 2.4.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeviceManagement",
  "identifier" : "/documentation/DeviceManagement/StatusAppManagedList",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Device Management"
    ],
    "preciseIdentifier" : "rmdm-status:StatusAppManagedList"
  },
  "title" : "StatusAppManagedList"
}
-->

# StatusAppManagedList

The status item that lists the device’s declarative managed apps.

```
object StatusAppManagedList
```

## Discussion

### Status item availability

|||
|--------------------------------|---------------------------------|
|Allowed in supervised enrollment|iOS, macOS, Shared iPad, visionOS|
|Allowed in device enrollment    |iOS, Shared iPad, visionOS       |
|Allowed in user enrollment      |iOS, macOS, Shared iPad, visionOS|
|Allowed in local enrollment     |N/A                              |
|Allowed in system scope         |iOS, macOS, Shared iPad, visionOS|
|Allowed in user scope           |macOS                            |

### Reason Codes

- `Error.AppStoreDisabled`: The App Store is disabled.
- `Error.DownloadFailed`: The app download failed.
  - `Timestamp`: (string) The RFC 3339 timestamp of the last download failure.
- `Error.DuplicateConfiguredApp`: The app is already being managed.
- `Error.InstallFailed`: The app install failed.
  - `Timestamp`: (string) The RFC 3339 timestamp of the last install failure.
- `Error.InvalidAppID`: The app id could not be found.
- `Error.InvalidCodeSignature`: The code signature of the app does not match the composed identifier, and the app cannot be managed.
- `Error.IsSystemApp`: The app is a system app that cannot be managed.
- `Error.LicenseNotFound`: A license for the app was not available.
- `Error.NotAnApp`: The downloaded data is not a valid app.
- `Error.NotSupported`: The app is not supported on this device.
- `Error.UnmanagedAppAlreadyInstalled`: An unmanaged app is already installed and cannot be managed.
- `Error.UserRejected`: The user rejected management of the app.
- `Info.UpdateAvailable`: An update is available for the app.
- `Error.UpdateFailed`: The app update failed.
  - `Timestamp`: (string) The RFC 3339 timestamp of the last update failure.

### Status item example

**New or updated app:**

Reports a new or updated app.

```json
{
    "app": {
        "managed": {
            "list": [
                {
                    "identifier": "com.example.productivity",
                    "declaration-identifier": "com.example.app-management",
                    "name": "Productivity App",
                    "external-version-id": 845960,
                    "version": "5.2.1",
                    "short-version": "5.2.1",
                    "state": "managed"
                }
            ]
        }
    }
}
```

**Removed app:**

Reports a removed app.

```json
{
    "app": {
        "managed": {
            "list": [
                {
                    "identifier": "com.example.productivity",
                    "_removed": true
                }
            ]
        }
    }
}
```

## Topics

### Objects

[`object StatusAppManagedListAppObject`](/documentation/DeviceManagement/StatusAppManagedListAppObject)

A managed app.


---

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)