Skip to main content

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:

PropertyPredefined options
if applicable
Description
ICCIDIntegrated 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.
MSISDNMobile 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 nameName 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:

PropertyDescription
SIM IDUnique identifier of the SIM (referred to as the sim_id when working with the REST API).
Assigned device IDUnique identifier of the device the SIM is assigned to or No assigned device.
Assigned deviceName of the device that the SIM is assigned to, linked to the respective device's details page, or the Assign to device action.
IMSIInternational Mobile Subscriber Identity of the SIM.
SIM form factorThe standardized size, also known as form factor, of the SIM.
ConnectivityIndicates the type of connectivity available to the SIM (that is, Cellular only or Cellular and Satellite connectivity).
SIM typeDiagram and description of the SIM type, including the quality grade and form factors.
UsageCommon 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

PropertyValueWildcard supportDescription
ICCIDStringyesIntegrated circuit card identifier including the final Luhn checksum digit.
SIM statusPredefinednoList of possible device statuses, specifically: Issued, Activated, Suspended, and Factory Test.
SIM IDStringyesUnique identifier for a SIM.
MSISDNStringyesMobile Station International Subscriber Directory Number of the SIM.
Device IDStringyesUnique identifier for the device the SIM is attached to.
ConnectivityPredefinednoOption for showing only Satellite capable SIMs.
Device attachedPredefinednoShow all SIMs either With device or Without device attached.
IMSIStringyesInternational Mobile Subscriber Identity of the SIM.
EIDStringyeseUICC Identifier for the eSIM.
TechnologyPredefinednoType of SIM, specifically: Standard SIM, Consumer eSIM, M2M eUICC (eSIM), or IoT eUICC.
SIM form factorPredefinednoForm 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.

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.