Every subscriber moves through a small set of states. Changing state propagates across carriers in seconds, so you control cost and security in real time, not on a billing cycle.
The states
- stock → issued to your account, not yet dispatched.
- dispatched → sent out, not yet activated.
- trial → live on a trial allowance before it starts billing.
- active → live and able to carry data.
- suspended → billing paused, data blocked, instantly resumable.
- inactive → not carrying data and not billing.
- cancelled → permanently decommissioned.
Reading state over the API
# every subscriber currently suspended
curl -H "Authorization: Bearer simbearer_<prefix>_<secret>" -H "X-Customer-API-Key: simdev_<prefix>_<secret>" "https://management.simsonic.com/developer/api/sims/?status=suspended"Tip
The Developer API is read-plus-SMS today: List SIMs, Get SIM and Send SMS. State changes are made in the console at management.simsonic.com.
Heads up
A suspended subscriber stops new sessions immediately, but an open session can take up to a minute to tear down. If you need a hard cut, also revoke the Hyper ID.