v52

OpenAPI 3.1.0raw.githubusercontent.com2026-07-311,1941,9384.1 MB
SIM Cards

Deletes a SIM card

The SIM card will be decommissioned, removed from your account and you will stop being charged.<br />The SIM card won't be able to connect to the network after the deletion is completed, thus making it impossible to consume data.<br/> Transitioning to the disabled state may take a period of time. Until the transition is completed, the SIM card status will be disabling <code>disabling</code>.<br />In order to re-enable the SIM card, you will need to re-register it.

delete/sim_cards/{id}

Path parameters

idstring uuid required
Example:6a09cdc3-8948-47f0-aa62-74ac943d6c58

Identifies the SIM.

Query parameters

report_lostboolean

Enables deletion of disabled eSIMs that can't be uninstalled from a device. This is irreversible and the eSIM cannot be re-registered.

Response

Successful response

Example response

{
  "data": {
    "actions_in_progress": true,
    "authorized_imeis": [
      "106516771852751",
      "534051870479563",
      "508821468377961"
    ],
    "created_at": "2018-02-02T22:25:27.521Z",
    "current_billing_period_consumed_data": {
      "amount": "2049.0",
      "unit": "MB"
    },
    "current_device_location": {
      "accuracy": 1250,
      "accuracy_unit": "m",
      "latitude": "41.143",
      "longitude": "-8.605"
    },
    "current_imei": "457032284023794",
    "current_mcc": "410",
    "current_mnc": "260",
    "data_limit": {
      "amount": "2048.1",
      "unit": "MB"
    },
    "esim_installation_status": "released",
    "iccid": "89310410106543789301",
    "id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    "imsi": "081932214823362973",
    "ipv4": "192.168.0.0",
    "ipv6": "2001:cdba:0000:0000:0000:0000:3257:9652",
    "live_data_session": "connected",
    "msisdn": "+13109976224",
    "pin_puk_codes": {
      "pin1": "1234",
      "pin2": "5678",
      "puk1": "12345678",
      "puk2": "87654321"
    },
    "record_type": "sim_card",
    "resources_with_in_progress_actions": [],
    "sim_card_group_id": "6a09cdc3-8948-47f0-aa62-74ac943d6c58",
    "status": {
      "reason": "The SIM card is active, ready to connect to networks and consume data.",
      "value": "enabled"
    },
    "tags": [
      "personal",
      "customers",
      "active-customers"
    ],
    "type": "physical",
    "updated_at": "2018-02-02T22:25:27.521Z",
    "version": "4.3"
  }
}