Sim Cards


The main objective of the platform is to manage the connectivity service and the inventory of SIMs.

Among other things, users can:

  • View inventory of SIM cards
  • Perform Bulk Actions
  • View usage, locations, call detail records and historical information
  • Troubleshoot issues
  • Assign attributes
  • Assign tags
  • Send/receive SMS


To view the SIM Cards list click on the SIM Cards section in the left menu and then click on the List option.

sim_card_list4 SIM Card list view.

Each row has all of the important information associated with the SIM Cards, such as ICCID, MSISDN, Label, Rate Plan, SIM Card, Data and session Status, Monthly data and SMS usages, last location, tags, attributes, etc.


You can always hide some columns, if you think the table is too big. Some details are hide by default (e.g. Date first registered, IMSI, etc.).

To export the information you can click “Export” and choose the method to export the information, see SIM Cards Export for more information.

Bulk Actions

The platform allows you to take actions (e.g. change SIM card states, etc.) to several SIM Cards at the same time. To do this, you need to check the desired SIM cards, in the SIM card list, and choose the action to perform in the Bulk Actions select box.

The following action are possible:

  • Change Status
  • Change Data Status
  • Change Tags
  • Change Attribute
  • Send SMS

SIM Card Details

You can see all of the SIM card details (e.g., ICCID, MSISDNs, Tags, etc.) in a single page, do actions on it (e.g., change state), view the monthly traffic and requests special configurations.


The single page shows all of the SIM Card information. You can edit some of it details (e.g. label, description, attributes, etc. ), to do this, click on the Edit button.

sim_card_details_details4 SIM Card details.

You also can see the status information of the SIM card, like the SIM card status and data status, current device and last location.

sim_card_details_status4 SIM Card status.

The show map button in the location row opens a pop up that shows where the SIM card is located, based on the last location.

sim_card_details_map4 SIM Card map.

An overview of the monthly usage or the billing cycle usage can be viewed in the Usage section:

sim_card_details_usage4 SIM Card usage.

Special Configurations Users with the right permissions can request for special configurations: fixed IP addresses, private APN and VPN.

sim_card_details_special_config4 SIM Card special configuration.

Swap SIM card

When a SIM card gets broken or is stolen, you can move the information such as CDRs, location updates and rules to another SIM card in the Provisioned or Pre-Active state.


This action is not reversible.


All history is recorded by the platform from the CDR, to SMS content, notifications, locations updates and rules triggered. The information is shown in dedicated pages.

All the information can be exported. See the SIM Cards Export for detail information.


The platform also provides a timeline with all the content related to a SIM card, giving a more friendly view of the SIM card usage. The following image shows a timeline for a SIM card:

sim_card_timeline4 SIM Card details timeline.


Organizations can manage the life-cycle of their SIM Cards, since the day they are provisioned until they are retired. Truphone also has the ability to Block or Remove SIM cards from the organizations’ accounts.

The next figure shows the SIM cards life cycle and the transitions:


Please note that some states (e.g. Test state) may not be available in your account.

sim_card_status4 SIM Card life-cycle.

Below is a description of each of the transitions:

User Transition performed manually by a user of the account. Operator Transition performed manually by Truphone. Backend Transition performed automatically by the back-end of the platform. The transition may have been configured by the User (e.g., rules) or by the Operator (e.g., invoices not paid). Network Transition performed automatically based on information from the network (e.g., change from Pre-Active to Active once the network detects that the device tried to connect). Below is a description of each of the states:

Provisioned This is the first state of the SIM Cards in the platform. In this state the SIM card will not be able to generate any traffic. From this SIM Card state, the Users (U) and the Operator (O) can use the platform actions to change the SIM card state to Test, Pre-Active, Active or Retire states. The Operator can also Block the SIM card and the Back-end (B) system can Block or Retire the SIM cards if they expire. Test The Test state allows the devices to consume some traffic with the SIM Card (e.g. 1MB and 10 SMS) without being charged. The Users and the Operator can change from this state to Provisioning or Retired states. After all the usage is spent, the Network (N) changes the SIM card to Provision state. The Back-end system can Retire the SIM card if they expire. Pre-Active In the Pre-Active state, the network automatically activates the SIM card once it is detected inside a device. The Users and the Operator can Activate the SIM card or Retire it. The Operator and the Backend system can Block the SIM card. Active In this state the SIM Card is active and ready to communicate. All traffic in this state is charged. The Users can use the platform actions to Suspend or Retire the SIM card. The Operator and the Back-end system can Suspend, Block or Retire the SIM card. Suspended In this state the SIM Card is suspended and cannot communicate. The Users can Activate or Retire the SIM card. The Operator can also Block the SIM card. Blocked In this state the SIM card does not communicate. The Users cannot change to any state and only the operator can restore the previous state. Retired This is the last state for the organizations users. In this state, the SIM Card is terminated and cannot go back to previous states. The Users can still view all the details and history for that SIM card. The Operator can Remove the SIM card. Removed This is the last SIM card state and will no longer be visible by users.


The platform attributes feature gives you the option to create attributes to associate with the SIM cards, then you can add a value for that attribute in each SIM card.

To view the attributes list, click on the SIM Cards section in the left menu and then click on the Attributes option.

The following table shows an example for two attributes (Priority and ID):

sim_card_attributes4 Attributes list view.

To create a new attribute click on the Add Attributes button. For each row, you have the ability to edit or delete it.


The platform tags feature gives you the option to create tags and associate them across the SIM cards.

To view the tags list, click on the SIM Cards section in the left menu and then click on the Tags option.

tags_list4 Tags list view.

To create a new tag click on the Add Tag button. For each row, you have the ability to edit or delete it.


When you edit a Tag you can select SIM cards to have it associated.

You can have multiple tags associated to a SIM cards. The following figure of the SIM Card list shows a SIM Card with two tags and another with only one tag.

sim_card_tags4 Tags view in the SIM Card list.

Send SMS

The platform allow users to send normal or binary SMS to the devices and accepts incoming SMS, showing the content of each message.

To send SMS, you can click on the SIM Cards section in the left menu and then click on the Send SMS option. When the page is loaded, select the SIM Cards you want to send the SMS and write the message content.

sim_card_send_sms_form4 Send SMS form.

After sending the SMS, the history is recorded in the table below.

sim_card_send_sms_history4 Send SMS history.


Note that in the history table is only displayed the current month SMS.