Working with eUICC Devices

Working with eUICC Devices

Contents

Overview

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.

Service State and Profile Status

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.

Activating eUICC Devices

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.

Working with Profiles

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.

Getting Profile Status

The response to a POST /devices/actions/list request includes the profile status of a device as an extended attribute.