<!--
{
  "availability" : [
    "iOS: 13.0.0 -",
    "iPadOS: 13.0.0 -",
    "macCatalyst: 13.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeviceManagement",
  "identifier" : "/documentation/DeviceManagement/Refresh-Cellular-Plans-Command",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Device Management"
    ],
    "preciseIdentifier" : "rest:put:mdm#RefreshCellularPlansCommand"
  },
  "title" : "Refresh Cellular Plans"
}
-->

# Refresh Cellular Plans

Query a carrier URL for active eSIM cellular-plan profiles on a device.

## Discussion

### Error codes

An error response uses one of the following error codes:

- `36001`: Unable to communicate with the cellular software stack.
- `36002`: The hardware doesn’t support this command.
- `36003`: The cellular stack was unable to perform the request. This error can also occur if the cellular stack is busy, in which case, retrying the command later may resolve the issue.

### Command availability

|||
|--------------------------|----------------|
|Device channel            |iOS, Shared iPad|
|User channel              |N/A             |
|Requires supervision      |N/A             |
|Allowed in user enrollment|N/A             |
|Required access right     |N/A             |

### 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>RefreshCellularPlans</string>
        <key>eSIMServerURL</key>
        <string>http://server.example.com</string>
    </dict>
    <key>CommandUUID</key>
    <string>0001_RefreshCellularPlans</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_RefreshCellularPlans</string>
    <key>Status</key>
    <string>Acknowledged</string>
    <key>UDID</key>
    <string>00008020-000915083C80012E</string>
</dict>
</plist>
```

## Topics

### Commands and responses

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

The command to query a carrier URL for active eSIM cellular-plan profiles on a device.

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

A response from the device after it processes the command to query a carrier URL for active eSIM cellular-plan profiles on a device.



---

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)