SIM inventory

The SIM Inventory provides a complete list of your registered SIMs.

View your SIMs

The SIM Inventory page displays a list of all your SIMs. The following columns are available:

Property	Predefined options if applicable	Description
ICCID		Integrated circuit card identifier including the final Luhn checksum digit. In the Details view, this field is listed as ICCID with Luhn and the check digit appears in bold.
MSISDN		Mobile Station International Subscriber Directory Number of the SIM.
SIM Status	Issued Activated Suspended Factory Test	Current state of the SIM. For details and configuration instructions, see SIM lifecycle management.
Device name		Name of the device that the SIM is assigned to, linked to the respective device's details page, or Not assigned.
Technology	Standard SIM M2M eUICC (eSIM) Consumer eSIM iSIM	One of the available SIM technology types.

info

For each SIM, click anywhere on the table row to open the Details view.

Quick actions

When you hover over a SIM, a appears to trigger the Assign to device quick action.

Manage SIMs

The Details view shows all identifiers and properties for an individual SIM. This includes everything shown in the SIM Inventory table, as well as:

Property	Description
SIM ID	Unique identifier of the SIM (referred to as the sim_id when working with the REST API).
Assigned device ID	Unique identifier of the device the SIM is assigned to or No assigned device.
Assigned device	Name of the device that the SIM is assigned to, linked to the respective device's details page, or the Assign to device action.
IMSI	International Mobile Subscriber Identity of the SIM.
SIM form factor	The standardized size, also known as form factor, of the SIM.
Connectivity	Indicates the type of connectivity available to the SIM (that is, Cellular only or Cellular and Satellite connectivity).
SIM type	Diagram and description of the SIM type, including the quality grade and form factors.
Usage	Common use cases for this SIM type.

Additional views

Events and Statistics are additional views that provide logs and aggregated usage, respectively, if the SIM has been assigned to a device and is Active.

Filter SIMs

Filters on the SIM Inventory table allow you to query SIMs based on one or more properties (for example, ICCID or form factor).

Select the filter you want to edit and enter a value. To add multiple filter values, press the Tab key. Once you've entered all the values you want to filter by, press the Enter key or click Apply.

To remove a filter or value, click the corresponding .

Filters can be combined or used together with the search bar. Filtered values are saved in the URL as a query parameter (for example, after filtering for an EID containing 890, the URL includes &eid=890 at the end).

warning

Your selected filters remain active when you open a SIM's details. However, the filters reset if you go to another page in the Portal.

Available filters

Property	Value	Wildcard support	Description
ICCID	String	yes	Integrated circuit card identifier including the final Luhn checksum digit.
SIM status	Predefined	no	List of possible device statuses, specifically: Issued, Activated, Suspended, and Factory Test.
SIM ID	String	yes	Unique identifier for a SIM.
MSISDN	String	yes	Mobile Station International Subscriber Directory Number of the SIM.
Device ID	String	yes	Unique identifier for the device the SIM is attached to.
Connectivity	Predefined	no	Option for showing only Satellite capable SIMs.
Device attached	Predefined	no	Show all SIMs either With device or Without device attached.
IMSI	String	yes	International Mobile Subscriber Identity of the SIM.
EID	String	yes	eUICC Identifier for the eSIM.
Technology	Predefined	no	Type of SIM, specifically: Standard SIM, Consumer eSIM, M2M eUICC (eSIM), or IoT eUICC.
SIM form factor	Predefined	no	Form factor of the SIM, specifically: 2FF Industrial SIM, 3FF Industrial SIM, 4FF Industrial SIM, Industrial MFF2 SIM, Dual Cut Commercial SIM, Tripe Cut Commercial SIM, Consumer eSIM, or iSIM.

Wildcard support

A wildcard filter lets you find various value forms based on a partial match. You can also use character matching with an asterisk *.

This is especially useful if a term has multiple spellings or you're unsure of the exact value.

For example, you can search for SIMs with phone numbers that contain specific numbers or area codes. Filtering the MSISDN value for 55 shows all SIMs with phone numbers that include 55, but filtering for 55* shows only SIMs with phone numbers that start with 55 (Brazil). Another example is filtering ICCID values with * at the end (for example, 8988303000008013931*) when you're unsure of its Luhn checksum digit.

Upload a CSV file

You can use a comma-separated values (CSV) file to apply multiple values to any filter that accepts string values.

This feature is especially useful if you have dozens of values (for example, 100 ICCIDs). Importing values through a CSV file lets you skip the tedious task of entering each value individually.

To upload a CSV file, follow these steps:

1. On SIM Inventory, choose the corresponding filter for the property in your CSV file (for example, ICCID).
2. Click Import a CSV file.
3. Drag and drop the file or select Browse file to find the file you want to import.
4. Verify the file name and line count are correct, then click Confirm.

Each value is parsed, and the table shows any SIMs with the corresponding values.

note

Uploading a CSV file won't overwrite any existing filters. To add or remove any values, select the filter again.

Please note the following limits:

• You can only upload one .csv or .txt file at a time
• Maximum rows: 10,000
• Maximum row length: 100 characters
• The CSV file size can't exceed 400 KB in total

tip

You can download and view a sample CSV file to use as a template. Choose the filter, select Import a CSV file, then click Download example of right format CSV.

Enter a list of values

You can also enter a list of values to filter for multiple ones simultaneously. This works for any property that accepts string values.

Lists must be plain text with every value on its own line. Write the values exactly as they appear in the Portal.

To demonstrate, if you enter the following in the SIM ID filter and press the Enter key:

12345
67890
90210

Each value is parsed, and the table shows any devices with the 12345, 67890, and 90210 IDs.

Order or register SIMs

To expand your SIM inventory, follow the appropriate link at the top of the page:

• To visit the SIM Shop, select Order SIMs.
• To register SIMs, either individually or in batches, select Register SIMs.

tip

Step-by-step guides are available for ordering SIMs from the SIM Shop and registering SIMs.

Bulk actions

You can also perform bulk actions on a group of SIMs.

Create devices

info

Customers with the Plus Package or Pro Package can create devices in factory test mode (FTM). See Activate FTM while creating devices for more specific instructions.

1. In the SIM Inventory, select the checkbox next to every SIM you want to create a device for.
2. A new menu at the top of the page provides bulk operations. Select Create devices.
3. Name your device and assign a service policy and coverage policy. Optionally, add tags, indicate the IP address, or lock the IMEI.
4. Under Select Device status, choose a device status.
   tip

   For more information about how the SIM status and device status interact, see Device troubleshooting.

5. Review, then click Create device.
   note

   The button text may vary depending on the number of devices you're creating.

The process can take up to 20 seconds for 500 devices. You aren't blocked from using the Portal and navigating to another page during this time. Assuming no errors, you should have at least one new device. 🎉

Deactivate SIMs

1. In the SIM Inventory, select the checkbox next to every SIM you want to create a device for.
2. A new menu at the top of the page provides bulk operations. Select Deactivate SIMs.
   warning

   There's no confirmation or undo for this action. Be sure to double-check your selection.

Transfer SIMs between Workspaces

For step-by-step instructions, see the Transfer SIMs between Workspaces guide.

info

The ability to transfer SIMs between Workspaces is available only to customers with multiple Workspaces. Find a full feature description and billing implications in the Transfer SIMs between Workspaces section.