SIM states and statuses - Hologram Documentation

A SIM status helps describe the current status of a SIM’s configuration and its expected ability to transmit data. This status is based on the network state of the currently enabled profile on the SIM card. If you’ve used the Hologram REST API, this is the state or networkState field value. This is used to indicate the state of the SIM with regards to the network. SIMs in your dashboard are organized by these statuses within the SIMs pages in the main menu, and when viewing a single SIM’s details page. Some important status terms to note:

A SIM that the system paused automatically (for a reached data limit, SMS limit, or low balance) shows as Paused by system.
A SIM your team paused manually and is still billed a Monthly Recurring Charge (MRC) shows as Paused by user. This is often known as a “suspended” SIM.
Permanently stopping a SIM and its charges is deactivation, a separate action.

Where to find SIM statuses

In your dashboard, SIM statuses are listed on the SIMs page views in the SIM status column. You can filter by SIM status using the Filter pane on the left-hand side of the page. Hover over any status in the table for a more detailed description of that status.

SIM status column showing different status indicators with filter panel on left

Find more detailed information about a SIM status by clicking on a SIM or searching for it to open the SIM details page. SIM status is shown in the page header. The Status tab status shows more detailed information about the status, and how we interpret that status. SIM statuses are based on the networkState of the enabled profile, if the SIM has connected through a device, and if a connection has been made to a network via a data session. The networkState field value is listed under the Profile section of the Status overview.

All SIM statuses and states

Active SIM statuses

SIMs in the following statuses are generally referred to as “Active SIMs” — SIMs that are connected to networks through our carrier partners, are able to use data, and are charged a monthly recurring charge. Please know that state changes do not interrupt active data sessions. This includes the “paused” SIM statuses. If a device is in a active data session, a request to pause a SIM in the Hologram portal will not interrupt that data session.

SIM status	Category	Network state (API)	Status description
Ready	Active	`LIVE`	This SIM is activated and able to connect to the Hologram network.
Connected	Active	`LIVE`	This SIM is currently connected to our network, or has connected recently to our network and has an open data session. Real-time session info varies by carrier.
Pending	Configuring	`LIVE-PENDING`	This SIM is being configured for use on the Hologram network. (Includes SIMs that are activating for the first time, and SIMs that are resuming data usage from a `PAUSED-...` state.)
Pausing	Configuring	`PAUSE-PENDING-USER`	This SIM is being paused by a member of your organization. Once paused, it will not be able to transmit data or SMS services.
Pausing	Configuring	`PAUSE-PENDING-SYS`	This SIM is being paused due to an insufficient account balance, data usage limit, SMS usage, or another reason. Once paused, it will not be able to transmit data or SMS services.
Paused by user	Paused	`PAUSED-USER`	This SIM has been manually paused by a member of your organization. While paused, your device will not be able to send or receive data or SMS messages.
Paused by system	Paused	`PAUSED-SYS`	This SIM has been paused and cannot use data or SMS services. Once resolved, it may take up to 10 minutes to resume activity on the Hologram network. SIMs are often paused by reaching a data usage or SMS limit, or a lack of account balance.

Note: The Connected status displays if the SIM’s current session is assumed to be “open,” meaning the session has no end time. There is no Connected state in the REST API, as the status is derived from the lastsession’s active parameter. Last active times in dashboard and usage reports do not currently account for open sessions.

Pre-deployment SIM statuses

SIM status	Category	Network state (API)	Status description
Available	Inactive	`INACTIVE`	This SIM is assigned to your organization, but has not been activated. Activate it at any time to start using data on the Hologram network.
Entering testing	Configuring	`TEST-ACTIVATE-PENDING`	This SIM is being configured for pre-deployment testing. Configuration can take up to 15 minutes. Timing varies based on network partner activity.
In testing	In testing (test mode)	`TEST-ACTIVATE`	This SIM is in pre-deployment testing. The SIM will auto-activate when your testing period ends, it uses 100 KB of data, or sends 10 SMS messages.
Connected	In testing (test mode)	`TEST-ACTIVATE`	This SIM is currently connected to our network, or has connected recently to our network and has an open data session. Real-time session info varies by carrier. This SIM is in pre-deployment testing. The SIM will auto-activate when your testing period ends, it uses 100 KB of data, or sends 10 SMS messages.

Note: Legacy configuration states that are no longer used for new SIMs include TEST-AUTOACTIVATE-PENDING, TEST-HIBERNATE-PENDING, TEST-AUTOACTIVATE, TEST-HIBERNATE, and INACTIVE-TESTED These states may appear for in some organizations for some older SIMs.

Deactivated SIM statuses

SIM status	Category	Network state (API)	Status description
Deactivating	Configuring	`DEAD-PENDING`	This SIM is being permanently deactivated. Once deactivated, it will no longer be able to transmit data or SMS services.
Deactivated	Deactivated	`DEAD`	This device has been permanently deactivated from use on the Hologram network and cannot be reactivated.

​Where to find SIM statuses

​All SIM statuses and states

​Active SIM statuses

​Pre-deployment SIM statuses

​Deactivated SIM statuses

Where to find SIM statuses

All SIM statuses and states

Active SIM statuses

Pre-deployment SIM statuses

Deactivated SIM statuses