> This page is for Home.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.emnify.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.emnify.com/_mcp/server.

> Device status management events in the emnify platform

> **Note**
>
> User information is available for actions performed through the emnify Portal or API with [user credentials](/developers/auth/user-credentials).
> Actions authenticated with application tokens don't include user details.
>
> For more information, see [User tracking for auditing](/system-events#user-tracking-for-auditing).

| ID | Description                               |
| :- | :---------------------------------------- |
| 8  | [SIM activation](#sim-activation)         |
| 9  | [SIM suspension](#sim-suspension)         |
| 10 | [SIM deletion](#sim-deletion)             |
| 42 | [Endpoint enabled](#endpoint-enabled)     |
| 43 | [Endpoint disabled](#endpoint-disabled)   |
| 45 | [SIM factory test](#sim-factory-test)     |
| 48 | [SIM registration](#sim-registration)     |
| 50 | [SIM Released](#sim-released)             |
| 51 | [SIM Assigned](#sim-assigned)             |
| 68 | [Reset connectivity](#reset-connectivity) |
| 69 | [SIM migration](#sim-migration)           |

### SIM activation

The SIM is patched to the **Activated** [status](https://www.emnify.com/iot-glossary#sim-status) after previously holding one of the following statuses:
**Issued**, **Suspended**, or **Factory Test**.

You can manually trigger this event by using the [emnify Portal or REST API](/system-events/usage).
Or, it's automatically triggered when the factory test mode threshold (data or SMS) is reached.

> **Info**
>
> Activated SIMs can use network services.

#### Example JSON response: SIM status changed from \*\*Suspended\*\* to \*\*Activated\*\*

```json maxLines=10
{
    "timestamp": "2021-10-27T08:44:56.147Z",
    "alert": false,
    "description": "Status of SIM changed from 'Suspended' to 'Activated'",
    "id": 2107485359,
    "event_type": {
        "id": 8,
        "description": "SIM activation"
    },
    "event_source": {
        "id": 2,
        "description": "API"
    },
    "event_severity": {
        "id": 0,
        "description": "Info"
    },
    "organisation": {
        "id": 624,
        "name": "Test Org"
    },
    "user": {
        "id": 12345,
        "name": "Sample User",
        "username": "user@example.com"
    },
    "endpoint": {
        "id": 83173458,
        "imei": "9953599921446542",
        "ip_address": "174.249.170.160",
        "name": "Factory Test Sim 2",
        "tags": null
    },
    "sim": {
        "iccid": "8242757752885188552",
        "id": 3668977,
        "production_date": "2020-12-23T13:02:11.000Z"
    },
    "imsi": {
        "id": 323245909,
        "import_date": "2020-12-23T13:02:11.000Z",
        "imsi": "44137163473706"
    }
}
```

#### Example JSON response: SIM activation after Factory Test volume reached

```json maxLines=10
{
    "timestamp": "2021-10-27T11:58:15.000Z",
    "alert": false,
    "description": "SIM activated after factory test volume reached.",
    "id": 15235673491,
    "event_type": {
        "id": 8,
        "description": "SIM activation"
    },
    "event_source": {
        "id": 1,
        "description": "Policy Control"
    },
    "event_severity": {
        "id": 0,
        "description": "Info"
    },
    "organisation": {
        "id": 35216,
        "name": "Test Org"
    },
    "endpoint": {
        "id": 39654118,
        "imei": "8516353639994804",
        "ip_address": "174.238.2.179",
        "name": "Factory Test Sim 2",
        "tags": null
    },
    "sim": {
        "iccid": "57486230661905310281",
        "id": 598611,
        "production_date": "2020-12-23T13:02:11.000Z"
    },
    "imsi": {
        "id": 7790199,
        "import_date": "2020-12-23T13:02:11.000Z",
        "imsi": "984189013845491"
    },
    "detail": {
        "transition": {
            "sim": {
                "status": {
                    "from": {
                        "id": 4,
                        "description": "FACTORY TEST"
                    },
                    "to": {
                        "id": 1,
                        "description": "ACTIVATED"
                    }
                }
            },
            "reason": "SIM reached factory test volume."
        }
    }
}
```

### SIM suspension

The SIM is patched to the **Suspended** [status](https://www.emnify.com/iot-glossary#sim-status), temporarily suspending and blocking it from network access.
Starting from the first day of the next month, the suspended SIM doesn't accrue any charges.

> **Tip**
>
> Activating a SIM with the **Suspended** status again is possible at any time.

#### Example JSON response

```json maxLines=10
{
    "timestamp": "2021-10-27T08:44:46.267Z",
    "alert": false,
    "description": "Status of SIM changed from 'Activated' to 'Suspended'",
    "id": 6664262361,
    "event_type": {
        "id": 9,
        "description": "SIM suspension"
    },
    "event_source": {
        "id": 2,
        "description": "API"
    },
    "event_severity": {
        "id": 0,
        "description": "Info"
    },
    "organisation": {
        "id": 4046,
        "name": "Test Org"
    },
    "user": {
        "id": 12345,
        "name": "Sample User",
        "username": "user@example.com"
    },
    "endpoint": {
        "id": 1541102,
        "imei": "3446623275770945",
        "ip_address": "227.147.158.142",
        "name": "Test Sim 2",
        "tags": null
    },
    "sim": {
        "iccid": "8930423315326577121",
        "id": 209035,
        "production_date": "2020-12-23T13:02:11.000Z"
    },
    "imsi": {
        "id": 90246192,
        "import_date": "2020-12-23T13:02:11.000Z",
        "imsi": "116892797180278"
    }
}
```

### SIM deletion

The SIM is deleted and permanently removed from the SIM inventory.

> **Warning**
>
> Once deleted, the SIM cannot be restored for network access.

#### Example JSON response

```json maxLines=10
{
    "timestamp": "2021-10-27T08:45:12.000Z",
    "alert": false,
    "description": "SIM 9224655 (89883030000011512247) has been deleted by user@example.com",
    "id": 2357494430400553,
    "event_type": {
        "id": 10,
        "description": "SIM deletion"
    },
    "event_source": {
        "id": 2,
        "description": "API"
    },
    "event_severity": {
        "id": 0,
        "description": "Info"
    },
    "organisation": {
        "id": 4046,
        "name": "Test Org"
    },
    "user": {
        "id": 219706,
        "name": "Sample User",
        "username": "user@example.com"
    },
    "sim": {
        "iccid": "89883030000011512247",
        "id": 9224655,
        "production_date": "2020-12-23T13:02:11.000Z"
    }
}
```

### Endpoint enabled

Device is enabled.

#### Example JSON response

```json maxLines=10
{
    "timestamp": "2021-10-27T08:44:52.828Z",
    "alert": false,
    "description": "Status of Endpoint 96485463 changed to Enabled",
    "id": 55793293648,
    "event_type": {
        "id": 42,
        "description": "Endpoint enabled"
    },
    "event_source": {
        "id": 2,
        "description": "API"
    },
    "event_severity": {
        "id": 0,
        "description": "Info"
    },
    "organisation": {
        "id": 6461,
        "name": "Test Org"
    },
    "user": {
        "id": 12345,
        "name": "Sample User",
        "username": "user@example.com"
    },
    "endpoint": {
        "id": 96485463,
        "imei": "1831095813329187",
        "ip_address": "121.214.125.202",
        "name": "Test Sim 2",
        "tags": null
    },
    "sim": {
        "iccid": "5363218780648553126",
        "id": 9270816,
        "production_date": "2020-12-23T13:02:11.000Z"
    },
    "imsi": {
        "id": 96756141,
        "import_date": "2020-12-23T13:02:11.000Z",
        "imsi": "87393970592520"
    }
}
```

### Endpoint disabled

Device is disabled.

#### Example JSON response

```json maxLines=10
{
    "timestamp": "2021-10-27T08:44:49.585Z",
    "alert": false,
    "description": "Status of Endpoint 28778135 changed to Disabled",
    "id": 19126170545,
    "event_type": {
        "id": 43,
        "description": "Endpoint disabled"
    },
    "event_source": {
        "id": 2,
        "description": "API"
    },
    "event_severity": {
        "id": 0,
        "description": "Info"
    },
    "organisation": {
        "id": 2448,
        "name": "Test Org"
    },
    "user": {
        "id": 12345,
        "name": "Sample User",
        "username": "user@example.com"
    },
    "endpoint": {
        "id": 28778135,
        "imei": "4042850244446350",
        "ip_address": "183.104.130.246",
        "name": "Test Sim 2",
        "tags": null
    },
    "sim": {
        "iccid": "5011996012476043533",
        "id": 5492364,
        "production_date": "2020-12-23T13:02:11.000Z"
    },
    "imsi": {
        "id": 5508107,
        "import_date": "2020-12-23T13:02:11.000Z",
        "imsi": "741161647249343"
    }
}
```

### SIM factory test

SIM is patched from **Issued** to **Factory Test** [status](https://www.emnify.com/iot-glossary#sim-status) (for SIM testing).

#### Example JSON response

```json maxLines=10
{
    "timestamp": "2021-10-27T11:30:52.684Z",
    "alert": false,
    "description": "Status of SIM changed from 'Issued' to 'Factory Test'",
    "id": 1955109934112,
    "event_type": {
        "id": 45,
        "description": "SIM factory test"
    },
    "event_source": {
        "id": 2,
        "description": "API"
    },
    "event_severity": {
        "id": 0,
        "description": "Info"
    },
    "organisation": {
        "id": 40163,
        "name": "Test Org"
    },
    "user": {
        "id": 12345,
        "name": "Sample User",
        "username": "user@example.com"
    },
    "endpoint": {
        "id": 896737335,
        "imei": "760116392707263",
        "ip_address": "199.153.59.220",
        "name": "Test Sim 2",
        "tags": null
    },
    "sim": {
        "iccid": "49176386291337319872",
        "id": 703869,
        "production_date": "2020-12-23T13:02:11.000Z"
    },
    "imsi": {
        "id": 391022,
        "import_date": "2020-12-23T13:02:11.000Z",
        "imsi": "165974752113101"
    }
}
```

### SIM registration

SIM or SIM batch is registered to a Workspace via a [Batch Identification Code (BIC)](https://www.emnify.com/iot-glossary#bic).

> **Info**
>
> This event doesn't trigger when the emnify team assigns SIMs to a Workspace.
> It also doesn't trigger for every SIM of a SIM batch, so the events log is only be visible on the individual SIM when registering single SIM batches.

#### Example JSON response

```json maxLines=10
{
  "timestamp": "2021-12-20T00:13:36.000Z",
  "alert": false,
  "description": "Batch of 1 SIM(s) registered.",
  "id": 9539556207944,
  "event_type": {
    "id": 48,
    "description": "SIM registration"
  },
  "event_source": {
    "id": 2,
    "description": "API"
  },
  "event_severity": {
    "id": 0,
    "description": "Info"
  },
  "organisation": {
    "id": 3376,
    "name": "Sample Corp"
  },
  "sim": {
    "iccid": "68429007768008033558",
    "id": 96112629,
    "production_date": "2020-05-15T08:50:07.000Z"
  },
  "user": {
    "id": 28757,
    "name": "Sample User",
    "username": "user@sample.com"
  },
  "detail": {
    "sim_batch": {
      "id": 57716,
      "sim_model": {
        "id": 9
      },
      "batch_size": 1,
      "first_iccid": "68429007768008033558",
      "last_iccid": "68429007768008033558"
    }
  }
}
```

### SIM Released

SIM is released from a device.

> **Note**
>
> Triggered through the [emnify User Interface (EUI)](https://support.emnify.com/hc/en-us/sections/115000969189-emnify-User-Interface-EUI-) or [REST API](/system-events/usage#event-api).

#### Example JSON response

```json maxLines=10
{
  "timestamp": "2021-12-15T07:39:24.905Z",
  "alert": false,
  "description": "SIM 3423335 released from endpoint 5749159",
  "id": 9511580614964,
  "event_type": {
    "id": 50,
    "description": "SIM Released"
  },
  "event_source": {
    "id": 2,
    "description": "API"
  },
  "event_severity": {
    "id": 0,
    "description": "Info"
  },
  "organisation": {
    "id": 316,
    "name": "Test Org"
  },
  "user": {
    "id": 12345,
    "name": "Sample User",
    "username": "user@example.com"
  },
  "endpoint": {
    "id": 5749159,
    "imei": "601262876950445",
    "ip_address": "182.112.132.120",
    "name": "Factory Test Sim 3",
    "tags": null
  },
  "sim": {
    "iccid": "4423772578905695775",
    "id": 3423335,
    "production_date": "2020-12-23T13:02:11.000Z"
  },
  "imsi": {
    "id": 63513617,
    "import_date": "2020-12-23T13:02:11.000Z",
    "imsi": "616139522755995"
  }
}
```

### SIM Assigned

SIM is assigned to a device.

> **Note**
>
> Triggered through the [emnify User Interface (EUI)](https://support.emnify.com/hc/en-us/sections/115000969189-emnify-User-Interface-EUI-) or while [creating an endpoint using the emnify REST API](/developers/api/endpoint/create-endpoint).

#### Example JSON response

```json maxLines=10
{
  "timestamp": "2021-12-15T07:45:45.807Z",
  "alert": false,
  "description": "SIM 2972420 assigned to endpoint 38463269",
  "id": 60798254506111,
  "event_type": {
    "id": 51,
    "description": "SIM Assigned"
  },
  "event_source": {
    "id": 2,
    "description": "API"
  },
  "event_severity": {
    "id": 0,
    "description": "Info"
  },
  "organisation": {
    "id": 89698,
    "name": "Test Org"
  },
  "user": {
    "id": 12345,
    "name": "Sample User",
    "username": "user@example.com"
  },
  "endpoint": {
    "id": 38463269,
    "imei": "821536534391790",
    "ip_address": "100.102.41.214",
    "name": "Factory Test Sim 3",
    "tags": null
  },
  "sim": {
    "iccid": "10314787648254377158",
    "id": 2972420,
    "production_date": "2020-12-23T13:02:11.000Z"
  },
  "imsi": {
    "id": 5236562,
    "import_date": "2020-12-23T13:02:11.000Z",
    "imsi": "963687450685669"
  },
  "detail": {
    "imei": "821536534391790"
  }
}
```

### Reset connectivity

An action to reset a device's connectivity was triggered.
Resetting device connectivity resets the network state and allows the device to freshly reattach.

For more details on the subsequent series of events, see [Reset connectivity in Device troubleshooting](/portal/troubleshooting#reset-connectivity).

#### Example JSON response in the origin Workspace

```json maxLines=10
{
  "timestamp": "2025-01-13T18:46:33.000Z",
  "alert": false,
  "description": "Endpoint connectivity reset triggered",
  "id": 1799598796013575,
  "event_type": {
    "id": 68,
    "description": "Reset connectivity"
  },
  "event_source": {
    "id": 2,
    "description": "API"
  },
  "event_severity": {
    "id": 0,
    "description": "Info"
  },
  "organisation": {
    "id": 12345,
    "name": "Example Organization"
  },
  "endpoint": {
    "id": 123456789,
    "imei": null,
    "ip_address": "192.0.2.100",
    "name": "GPS Tracker",
    "tags": null
  },
  "sim": {
    "iccid": "89883030000080139311",
    "id": 12345,
    "production_date": "2019-10-10T13:06:24.000Z"
  },
  "detail": {
    "data": {}
  }
}
```

### SIM migration

One or more SIMs were transferred from a [source Workspace](https://www.emnify.com/iot-glossary#source-workspace) to a [target Workspace](https://www.emnify.com/iot-glossary#target-workspace).
This action generates two separate events:

* A source event in the originating Workspace, indicating which SIMs were transferred and where they were moved.
* A target event in the destination Workspace, confirming the receipt of the transferred SIMs.

> **Note**
>
> Transfers may impact SIM status and billing, as described in the [SIM transfer guide](/portal/workspaces#transfer-sims-between-workspaces).

#### Example JSON response in the source Workspace

```json maxLines=10
{
  "timestamp": "2025-01-23T08:46:32.000Z",
  "alert": false,
  "description": "SIM(s) migrated from workspace 1 to workspace 2 by user sasha@example.com",
  "id": 1234567890,
  "event_type": {
    "id": 69,
    "description": "SIM migration"
  },
  "event_source": {
    "id": 2,
    "description": "API"
  },
  "event_severity": {
    "id": 0,
    "description": "Info"
  },
  "organisation": {
    "id": 1,
    "name": "Example Workspace 1"
  },
  "user": {
    "id": 123,
    "name": "Sasha Q",
    "username": "sasha@example.com"
  },
  "detail": {
    "target_workspace": {
      "id": 2
    },
    "sims": [
      {
        "id": 12345,
        "iccid": "8988303000008013931",
        "iccid_with_luhn": "89883030000080139311",
        "source_workspace": {
          "id": 1,
          "name": "Example Workspace 1"
        }
      },
      {
        "id": 67890,
        "iccid": "8988303000008013931",
        "iccid_with_luhn": "89883030000080139311",
        "source_workspace": {
          "id": 1,
          "name": "Example Workspace 1"
        }
      }
    ],
    "type": "source"
  }
}
```

#### Example JSON response in the target Workspace

```json maxLines=10
{
  "timestamp": "2025-01-23T08:46:33.000Z",
  "alert": false,
  "description": "SIM(s) migrated to workspace 2 by user sasha@example.com",
  "id": 1234567890,
  "event_type": {
    "id": 69,
    "description": "SIM migration"
  },
  "event_source": {
    "id": 2,
    "description": "API"
  },
  "event_severity": {
    "id": 0,
    "description": "Info"
  },
  "organisation": {
    "id": 2,
    "name": "Example Workspace 2"
  },
  "user": {
    "id": 123,
    "name": "Sasha Q",
    "username": "sasha@example.com"
  },
  "detail": {
    "target_workspace": {
      "id": 2
    },
    "sims": [
      {
        "id": 12345,
        "iccid": "8988303000008013931",
        "iccid_with_luhn": "89883030000080139311",
        "source_workspace": {
          "id": 1,
          "name": "Example Workspace 1"
        }
      },
      {
        "id": 67890,
        "iccid": "8988303000008013931",
        "iccid_with_luhn": "89883030000080139311",
        "source_workspace": {
          "id": 1,
          "name": "Example Workspace 1"
        }
      }
    ],
    "type": "target"
  }
}
```