Change state
POST https://api.pegasusgateway.com/m2m/supersims/v1/Sims/:sid
You can change the state of the SIM to any of the following values: ready, active or inactive.
EndFragmen.
The following table describes the possible statuses of the SIM, some of these are temporary while the SIM changes states:
Status | Name | Description |
---|---|---|
new | Inventory | The SIM has never been enabled and is waiting to be activated so that it can connect to the network. A Sim resource can exist in new status indefinitely at no charge, but once it is transitioned to ready or active, it cannot be returned to new. |
ready | Ready to Activate | The SIM can connect to the network and is capable of consuming network resources in accordance with its Fleet, but no monthly subscription fee will be charged. A Sim resource’s status can only be updated to ready if it is currently new. Once the SIM has consumed 250KB of data, five SMS Commands have been sent to or received from the SIM, or three months have passed, the Sim resource’s status will automatically transition to active. Use ready to enable and test your connectivity before devices are sent to customers or deployed into the field without incurring monthly fees. |
active | Active | The SIM can connect to the network and is capable of consuming network resources in accordance with its Fleet. |
inactive | Inactive | The SIM is blocked from connecting to the network. |
scheduled | Scheduled to Change | The update is queued and will be processed when the network operator is ready. The Sim resource’s status will automatically transition to the requested status when the update operation is completed. |
Request Body
{"Status"=>"active"}