Level up your Twilio API skills in TwilioQuest, an educational game for Mac, Windows, and Linux. Download Now

Menu

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Programmable Wireless: Understanding SIM statuses

Now that you’ve got a Programmable Wireless SIM with a Rate Plan configured, you will want to make sure the SIM is Active on the cellular network.

What are SIM statuses?

The status of a SIM determines its state on the network. At any given time, the status of a SIM can be in one of eight different statuses:

  • new
  • ready
  • active
  • suspended
  • deactivated
  • canceled
  • scheduled
  • updating

The available status values of a Sim instance are described in the SIMs REST API. You can view those status values here.

You can check the status of your SIMs in the Console

In your Console, the status of your purchased SIMs are indicated in the Status column on the SIMs page, as well as on the Configure tab of a selected SIM.

SIM-status-options.png

You can check or change the status of a SIM on the Configure page:

  1. Open the SIMs section of the Console.
  2. Select any SIM, which will display Configure tab for that SIM.
  3. The current status will be shown in the STATUS dropdown menu.
  4. You can open the dropdown menu and change the status. Options include New (default), Ready and Active.

Need help registering a SIM? Refer to the Ordering and registering your first SIM guide.

SIM status scenarios and FAQ

Problem

Solution

I want to validate that my SIM can connect to the network without initiating a Monthly SIM Fee*.

* Not available for the Narrowband developer plan

Place your SIM in the ready state. You can send up to 250KB of data before it transitions to active. There is no Monthly Recurring Cost on a SIM in this state up to three months.

I want to quickly test a large number of SIMs without incurring a large MRC charge.

See above. Your SIM can live in the ready state for up to three months without charge.

Can a SIM use Programmable Voice or Programmable SMS in the ready state?

No, currently a SIM must be in the active state to use Programmable Voice and Programmable SMS. This support is coming soon.

I’ve got an active SIM but what can I do with it?

Your SIM is live and ready to use with the capabilities you’ve enabled.

Continue to the next sections to learn about machine-to-machine commands, make phone calls with Programmable Voice, or send text messages with Programmable SMS.

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.