An eUICC device has an embedded SIM (eSIM) that can be configured via downloadable profiles. Each eSIM initially contains a profile that is installed by the manufacturer, but profiles from Mobile Network Operators (MNOs) can be downloaded and enabled to allow the devices to work on different networks. Only one profile can be active at a time.
The ThingSpace Connectivity Management API includes endpoints for profile-related tasks, such as downloading and enabling profiles. It also has several other capabilities that are very useful when working with eUICC devices.
An eUICC device has both a service state and a profile status.
| Service State | Profile Status | Result |
|---|---|---|
| Active | Not Downloaded | The eUICC device has been activated and is ready for a profile to be downloaded. The activation response includes the ICCID of the device, and the ICCID is a required input parameter for all profile requests. This status also appears when a profile download fails. |
| Active | none | A profile has been downloaded to the device but has not been enabled. The device cannot connect to the Verizon Wireless network in local mode. |
| Active | DOWNLOAD_DISABLE | A profile has been downloaded to the device but has not been enabled. The device cannot connect to the Verizon Wireless network in local mode. |
| Active | DOWNLOAD_ENABLE | A profile has been downloaded and enabled. The device can attach to the Verizon Wireless network and use all services activated for the device. |
| Active | ENABLE | A profile was downloaded and enabled, and then subsequently disabled and enabled again. The device can attach to the Verizon Wireless network and use all services activated for the device. |
| Active | DISABLE | A profile was downloaded and enabled, and then subsequently disabled. The device cannot connect to the Verizon Wireless network in local mode. |
| Suspend | any status | The device cannot use services, but continues to be billed in accordance with the service plan. |
| Deactive | n/a | The device cannot use services, and is not billed. |
You must activate an eUICC device on the Verizon Wireless network before you can download a profile to it. Use the PUT /devices/actions/goToState endpoint to activate eUICC devices, specifying each device’s EID and MEID, or EID and SKU number as the device identifiers.
Use these endpoints to download, enabled, disable, and delete a local profile on a device. Note that you can only specify one device per request.
POST /devices/profile/actions/download_enablePOST /devices/profile/actions/download_disablePOST /devices/profile/actions/enablePOST /devices/profile/actions/disablePOST /devices/profile/actions/deleteThe response to a POST /devices/actions/list request includes the profile status of a device as an extended attribute.