ServicesPlatformEventsEvent types

Limit enforcement

Endpoint blocked

Device is blocked from all services after exceeding device policies (for example, reaching its traffic limit).

You can restore service by adjusting the device’s policies.

In the emnify Portal Automations, this event is referred to as Device blocked.

1{
2    "timestamp": "2021-10-27T14:44:11.000Z",
3    "alert": true,
4    "description": "Blocking data access for endpoint, traffic limit exceeded.",
5    "id": 155295222517,
6    "event_type": {
7        "id": 11,
8        "description": "Endpoint blocked"
9    },
10    "event_source": {
11        "id": 1,
12        "description": "Policy Control"
13    },
14    "event_severity": {
15        "id": 1,
16        "description": "Warn"
17    },
18    "organisation": {
19        "id": 42855,
20        "name": "Test Org"
21    },
22    "endpoint": {
23        "id": 29232748,
24        "imei": "31397643565228411",
25        "ip_address": "188.167.183.228",
26        "name": "Factory Test Sim 3",
27        "tags": null
28    },
29    "sim": {
30        "iccid": "1919136237414891188",
31        "id": 9979202,
32        "production_date": "2020-12-23T13:02:11.000Z"
33    },
34    "imsi": {
35        "id": 705745558,
36        "import_date": "2020-12-23T13:02:11.000Z",
37        "imsi": "54450740741651"
38    }
39}

Organisation blocked

The organization is blocked after exceeding the monthly cost limit (defined by emnify) or exceeding their prepaid balance (if not set up to be postpaid).

1{
2    "id": 1697107630311,
3    "timestamp": "2021-10-06 10:42:58",
4    "event_source": {
5        "id": 1,
6        "name": "Policy Control"
7    },
8    "event_severity": {
9        "id": 1,
10        "description": "WARN"
11    },
12    "event_type": {
13        "id": 12,
14        "description": "Organisation blocked"
15    },
16    "organisation": {
17        "id": 4732,
18        "name": "Test Org"
19    },
20    "user": null,
21    "alert": 1,
22    "description": "Blocking services for organisation, because of insufficient prepaid balance.",
23    "endpoint": null,
24    "sim": null,
25    "imsi": null,
26    "detail": null
27}
1{
2    "id": 656817714005,
3    "timestamp": "2021-10-06 10:42:58",
4    "event_source": {
5        "id": 1,
6        "name": "Policy Control"
7    },
8    "event_severity": {
9        "id": 1,
10        "description": "WARN"
11    },
12    "event_type": {
13        "id": 12,
14        "description": "Organisation blocked"
15    },
16    "organisation": {
17        "id": 6805,
18        "name": "Test Org"
19    },
20    "user": null,
21    "alert": 1,
22    "description": "Blocking services for organisation, because monthly cost limit exceeded.",
23    "endpoint": null,
24    "sim": null,
25    "imsi": null,
26    "detail": null
27}

Endpoint data traffic limit warning

A device with a configured data limit has hit its warning percentage. This event gives you time to take action before any limits are reached or exceeded.

Example: If the data limit is 100 MB and the warning percentage is 80%, the system generates an event when the used volume exceeds 80 MB and the remaining volume goes below 20 MB.

You can configure the data limit and choose a warning percentage in the service policy settings. For more information on how configure limits via the emnify Portal, see Configure data and SMS limits. To use the emnify REST API, see Add data limit to service profile.

In the emnify Portal Automations, this event is referred to as Monthly threshold.

1{
2  "timestamp": "2022-09-27T13:43:31.762Z",
3  "alert": true,
4  "description": "Endpoint has used up 75% of the configured monthly 50 MB data traffic limit.",
5  "id": 123456,
6  "event_type": {
7    "id": 65,
8    "description": "Endpoint data traffic limit warning"
9  },
10  "event_source": {
11    "id": 1,
12    "description": "Policy Control"
13  },
14  "event_severity": {
15    "id": 1,
16    "description": "Warn"
17  },
18  "organisation": {
19    "id": 123,
20    "name": "Example Organization"
21  },
22  "endpoint": {
23    "id": 12345,
24    "imei": null,
25    "ip_address": "192.0.2.215",
26    "name": "Example Device",
27    "tags": "demo"
28  },
29  "sim": {
30    "iccid": "89883030000080139311",
31    "id": 12345,
32    "production_date": "2019-10-10T13:06:17.000Z"
33  },
34  "imsi": {
35    "id": 12345,
36    "import_date": "2019-10-10T13:06:17.000Z",
37    "imsi": "295090004157478"
38  }
39}

SMS MO P2P limit reached

A device exceeded the daily SMS MO limit. By default, each device can send up to 5 peer-to-peer (P2P) SMS within a 24-hour interval. Afterwards, the messages are acknowledged but not forwarded to the final recipient and stored as failed.

The limit automatically resets 24 hours after the first message, and you still see all messages in your SMS console.

You are still charged for messages that aren’t forwarded due to this limit.

In the emnify Portal Automations, this event is referred to as Daily SMS limit.

1{
2  "timestamp": "2023-04-07T18:31:12.162Z",
3  "alert": true,
4  "description": "SMS to '8005550105' rejected, because P2P limit exceeded.",
5  "id": 123456,
6  "event_type": {
7    "id": 66,
8    "description": "SMS MO P2P limit reached"
9  },
10  "event_source": {
11    "id": 0,
12    "description": "Network"
13  },
14  "event_severity": {
15    "id": 1,
16    "description": "Warn"
17  },
18  "organisation": {
19    "id": 123,
20    "name": "Example Organization"
21  },
22  "endpoint": {
23    "id": 12345,
24    "imei": null,
25    "ip_address": "192.0.2.215",
26    "name": "Example Device",
27    "tags": "demo"
28  },
29  "sim": {
30    "iccid": "89883030000080139311",
31    "id": 12345,
32    "production_date": "2019-10-10T13:06:17.000Z"
33  },
34  "imsi": {
35    "id": 12345,
36    "import_date": "2019-10-10T13:06:17.000Z",
37    "imsi": "295090004157478"
38  }
39}

Endpoint limit extension

The data limit for the device has been extended for the remaining duration of the month.

Example: The device limit was extended by 100 MB for the remaining duration of the month.

1{
2    "timestamp": "2025-03-12T15:43:57.777Z",
3    "alert": false,
4    "description": "The data limit for Endpoint 31167090 is extended by 100.000000 MB for the remaining duration of the month.",
5    "id": 1881522799345936,
6    "event_type": {
7        "id": 70,
8        "description": "Endpoint limit extension"
9    },
10    "event_source": {
11        "id": 1,
12        "description": "Policy Control"
13    },
14    "event_severity": {
15        "id": 0,
16        "description": "Info"
17    },
18    "organisation": {
19        "id": 55,
20        "name": "Example Organization"
21    },
22    "endpoint": {
23        "id": 31167090,
24        "imei": null,
25        "ip_address": "255.255.0.199",
26        "name": "Test SIM",
27        "tags": null
28    },
29    "sim": {
30        "iccid": "1111103000006734684",
31        "id": 1397431,
32        "production_date": "2021-09-13T08:12:59.000Z"
33    },
34    "imsi": {
35        "id": 13416657,
36        "import_date": "2021-09-13T08:12:59.000Z",
37        "imsi": "295050901116173"
38    }
39}