Consumer eSIM Profiles

Some Soracom subscription plans are available as a downloadable eSIM profile instead of a physical SIM. If you are using a device that already has its own eSIM built-in as found in many smartphones and tablets or in some newer IoT devices, you can use the same eSIM profiles to add Soracom Air connectivity without the need to purchase and install a physical SIM card.

Once a Soracom eSIM profile is installed, your device will have the same coverage and access to platform features as other devices that use a physical Soracom IoT SIM card or eSIM.

Please note that Soracom eSIM profiles have additional requirements and limitations compared to Soracom IoT SIMs.

Requirements

Limitations

*1 - Although eSIM profiles do not support Subscription Containers, you can purchase and install multiple eSIM profiles, each with a different subscription plan. However, unlike Subscription Containers, each eSIM profile will be registered to your account as a separate SIM, and profiles will not automatically switch from one profile to another and instead must be manually switched using the device's Local Profile Assistant.

In addition, please note:


Available eSIM Profiles

The following subscription plans are available as eSIM Profiles:

Soracom eSIM Profile
Plan plan01s planX1 planP1
Pricing Pay-As-You-Go
Bundled Data
Coverage Over 140 countries *1 Japan (au/KDDI) Asia Pacific *1
Connectivity 2G, 3G, 4G/LTE, LTE Cat-M1, NB-IoT *2 2G, 3G, 4G/LTE *2 4G/LTE
Form Factors Downloadable eSIM Profile
Data
SMS MT-SMS only *3
USSD
Voice
Subscription Containers

*1 - Refer to the Supported Carriers documentation for carrier information.
*2 - Actual network availability varies by country and local operator.
*3 - Mobile Terminated SMS, or SMS delivered from Soracom to a device.


Ordering eSIM Profiles

Ordering eSIM profiles will incur the eSIM profile initial fee. In addition, once an eSIM profile has been provisioned, standard Soracom Air for Cellular fees apply. Refer to the Pricing & Fee Schedule for more information.

Before ordering eSIM profiles, make sure that your device is compatible with SGP.22 and Local Profile Assistant (LPA). Devices with an M2M eSIM that is based on the SGP.02 standard are not supported.

Once you have purchased an eSIM profile, it cannot be returned or refunded.

  1. Login to the User Console. From the Menu, open the Orders screen.

  2. Click the eSIM Profile Order button.

    https://console.soracom.io

  3. Then click the New eSIM Profile Order button.

    https://console.soracom.io

  4. Select the eSIM profile Subscription you want and enter the Quantity of profiles to provision, then click Next.

    https://console.soracom.io

    A maximum of 20 eSIM profiles may be purchased per order. If you would like to purchase more, please contact us.

  5. Finally, confirm your order details and click the Submit Order button.

    https://console.soracom.io

    An order confirmation screen will appear, and Soracom will begin provisioning eSIM profiles. Click the Done button to return to the eSIM Profile Orders screen.

    https://console.soracom.io


Checking eSIM Profile order status

The amount of time it takes to provision eSIM profiles depends on the number of profiles you have ordered. You can view the provisioning status of your order from the eSIM Profile Orders screen.

https://console.soracom.io

The Status of each order is as follows:

Order Status Description
Draft Your order was submitted but not yet confirmed. *1
Confirmed Your order has been confirmed. Soracom will begin provisioning the profiles in your order shortly.
In Progress Soracom is provisioning the profiles in your order.
Completed Soracom has finished provisioning the profiles, and you can now view the profile details.
Failed There was an error while provisioning the profiles.

*1 - Orders placed via the User Console will be automatically Confirmed. When ordering an eSIM profile using the Soracom API, use the SimProfileOrder:confirmProfileOrder API to confirm the order and begin provisioning. Drafted orders which are not confirmed are automatically deleted after 24 hours.

If your order is stuck in the In Progress status for more than 24 hours, please contact us for assistance.


Installing eSIM Profiles

Once an eSIM profile has been installed to a device, it cannot be reinstalled again or transferred to another device.

If you accidentally delete an eSIM profile from your device, you will need to terminate the SIM from your account, then provision and install a new eSIM profile.

Once your order is complete, you will be able to view the details of each profile in order to install it to your devices.

The instructions for installing an eSIM profile will depend on what device you are using. Please check your device manual for instructions on how to use its Local Profile Assistant (LPA) to install an eSIM profile.

Install using QR Code

If your device supports installing eSIM profiles by scanning a QR code:

  1. From the eSIM Profile Orders screen, click the List eSIM Profiles in order next to the order.

    https://console.soracom.io

  2. A list of eSIM Profiles that were provisioned in the order will be displayed. Click the View QR Code link to display the QR code, then use the Local Profile Assistant (LPA) on your device to scan the QR code and install the eSIM profile.

    https://console.soracom.io

Install using Activation Code

If your device requires installing eSIM profiles by entering an activation code:

  1. From the eSIM Profile Orders screen, click the List eSIM Profiles in order next to the order.

    https://console.soracom.io

  2. A list of eSIM Profiles that were provisioned in the order will be displayed. Click the Download CSV button to download a CSV file containing additional profile details.

    https://console.soracom.io

  3. Open the CSV file in a spreadsheet editor, then use the Local Profile Assistant (LPA) on your device to enter the Activation Code and other information to install the eSIM profile

The CSV file will contain the following data:

Column Description
SIM ID The SIM ID of the profile. You can use the SIM ID to manage the SIM, such as changing the Subscriber Status, Speed Class, or other functions.
IMSI The IMSI (International Mobile Subscriber Identity) of the profile.
Subscription The subscription plan of the profile.
SM-DP The URL of the SM-DP+ server providing the profile, used during profile installation.
Matching ID The Matching ID identifying the profile, used during profile installation.
Activation Code The Activation Code of the profile, used during profile installation.
Profile Status The current provisioning, installation, and activation status of the profile (see below).
Installed Time The time the profile was installed to your device.
Last Modified Time The time the profile was recently updated (for example, the Profile Status changed).

Please note that the names and positions of the columns in the CSV file may be subject to change. If you are using the CSV file in order to automate the process of installing Soracom eSIM profiles to multiple devices, please check that your system will select the appropriate column.


Enabling eSIM Profiles

Once you have installed an eSIM profile to your device, you must also enable it before your device will begin using it to connect to a network.

The instructions for enabling an eSIM profile will depend on the device you are using. Please check your device manual for instructions on how to use its Local Profile Assistant (LPA) to enable an eSIM profile.

Note that enabling an eSIM profile is not the same as activating a SIM by changing its Subscriber Status. eSIM profiles cannot be enabled from the User Console. You must enable the eSIM profile directly on the device using its Local Profile Assistant.

Once the eSIM profile has been enabled, you can then control the SIM using Subscriber Status.


Checking eSIM Profile installation status

When installing an eSIM profile to your device, you can also confirm the installation status from the User Console. This can be useful for keeping track of which profiles have already been installed when installing eSIM profiles to a large number of devices.

  1. From the eSIM Profile Orders screen, click the List eSIM Profiles in order button next to the order.

    https://console.soracom.io

  2. In the list of eSIM Profiles that were provisioned in the order, you can see the profile status.

    https://console.soracom.io

    The same information is included in the CSV file.

The Profile Status for each profile is as follows:

Profile Status Value in CSV file Description
Registered SUBSCRIBER_REGISTRATION_SUCCEEDEDED The profile was successfully provisioned and registered to your account, but has not yet been installed to a device.
Installed INSTALLATION_SUCCEEDED The profile was installed on your device, but has not yet been enabled on the device.
Activated *1 ACTIVATION_SUCCEEDED The profile was enabled on the device and is now ready for use.
Deactivated *1 INACTIVATION_SUCCEEDED The profile was disabled on the device.
Deleted *1 DELETION_SUCCEEDED The profile was deleted from the device.

*1 - In some cases, a device may not or be able to report to Soracom when the profile is activated, deactivated, or deleted.


Deleting eSIM Profiles

If you no longer need an eSIM profile, you can delete it from your device.

The instructions for deleting an eSIM profile will depend on the device you are using. Please check your device manual for instructions on how to use its Local Profile Assistant (LPA) to delete an eSIM profile.

Note that deleting an eSIM profile from your device will not automatically terminate the SIM in your account. After deleting an eSIM profile, make sure to terminate it from your account in order to avoid unnecessary fees.