json

{
  "ICCID": "8901240397190195850",
  "MSISDN": "+11234567890",
  "SimStatus": "Active"
}

{
  "ICCID": "8901240397190195850",
  "SimStatus": "Active",
  "Successful": true
}

Sims

Update SIM Status

Update the status of a SIM card using its ICCID. Use this to activate, suspend, or change the state of a physical or eSIM card in the network.

What this does: Returns the updated SIM SimStatus and a success confirmation. Valid statuses are Active, Suspended, and Empty. Use Active to enable the SIM, Suspended to temporarily disable it while retaining the number association, or Empty to clear all associations.

Next steps:

Confirm the change — GET /v1.0/numbers
Clear all SIM associations — POST /v1.0/sims/clear-status

POST

v1.0

sims

update-status

json

{
  "ICCID": "8901240397190195850",
  "MSISDN": "+11234567890",
  "SimStatus": "Active"
}

{
  "ICCID": "8901240397190195850",
  "SimStatus": "Active",
  "Successful": true
}

Body

application/json

ICCID

string

required

The ICCID of the SIM card to update

Example:

"8901240397190195850"

MSISDN

string

The phone number (MSISDN) associated with the SIM

Example:

"+11234567890"

SimStatus

enum<string>

The new status to set for the SIM card

Available options:

Active,

Suspended,

Empty

Example:

"Active"

Response

Success — returns the updated SIM status

The response is of type object.

Delete Service Item Clear SIM Status

⌘I