ServicesPlatformEventsEvent types

Network attachment and location

Update location

When a device attaches for the first time, it sends an authentication request. This request is immediately followed by an Update location event.

After the first authentication, the device sends additional Update location events to inform the network about the current location. This happens periodically or when entering a new location area.

The Update location event registers the device in the circuit-switched domain (2G/3G) and packet-switched domain (4G/LTE). It enables the network to know the location/region of the device to send/retrieve the subscription information. In 2G/3G it allows the device to send and receive SMS.

Example: a SIM card has (re)authenticated with a different network element. If successful, the device appears as Attached in the emnify Portal and is ready to receive SMS.

1{
2  "id": 176777623,
3  "alert": false,
4  "description": "New location received from VLR for IMSI='901430111111111', now
5attached to VLR='491720000095'.",
6  "timestamp": "2017-10-26T07:28:00.000+0000",
7  "event_type": {
8    "id": 1,
9    "description": "Update location"
10  },
11  "event_source": {
12    "id": 0,
13    "description": "Network"
14  },
15  "event_severity": {
16    "id": 0,
17    "description": "Info"
18  },
19  "organisation": {
20    "id": 215294,
21    "name": "Demo Company"
22  },
23  "endpoint": {
24    "id": 733023,
25    "name": "GPS Tracker",
26    "ip_address": "127.137.56.181",
27    "tags": null,
28    "imei": "732554536373291"
29  },
30  "imsi": {
31    "id": 216476,
32    "imsi": "401960166508658",
33    "import_date": "2016-12-27T10:09:23.000+0000"
34  },
35  "sim": {
36    "id": 2614385,
37    "iccid": "3590376990354243198",
38    "production_date": "2016-12-27T10:09:23.000+0000"
39  },
40  "detail": {
41    "id": 3,
42    "name": "Vodafone",
43    "country": {
44      "id": 74,
45      "name": "Germany",
46      "country_code": "49",
47      "mcc": "262",
48      "iso_code": "de"
49    },
50    "tapcode": [
51      {
52        "id": 2,
53        "tapcode": "DEUD2"
54      }
55    ],
56    "mnc": [
57      {
58        "id": 3,
59        "mnc": "02"
60      }
61    ]
62  }
63}

Update GPRS location

Similar to the Update location event, the Update GPRS location event shows the registration on the packet-switched (PS) domain. This event is also sent periodically or when changing the location area.

Example: a SIM card has successfully registered for data sessions with a different network element.

A device can only establish a data session after registering on the PS domain.

1{
2  "timestamp": "2021-10-24T12:44:09.901Z",
3  "alert": false,
4  "description": "New location received from SGSN for IMSI='668507304809640', now attached to SGSN='569307110740151', IP='213.181.60.148'.",
5  "id": 158057547412841,
6  "event_type": {
7    "id": 2,
8    "description": "Update GPRS location"
9  },
10  "event_source": {
11    "id": 0,
12    "description": "Network"
13  },
14  "event_severity": {
15    "id": 0,
16    "description": "Info"
17  },
18  "organisation": {
19    "id": 35030,
20    "name": "Test Org"
21  },
22  "endpoint": {
23    "id": 11396946,
24    "imei": "818076512105738",
25    "ip_address": "163.93.166.228",
26    "name": "Test Sim 2",
27    "tags": null
28  },
29  "sim": {
30    "iccid": "14610948273291945919",
31    "id": 1748517,
32    "production_date": "2020-12-23T13:02:11.000Z"
33  },
34  "imsi": {
35    "id": 322634,
36    "import_date": "2020-12-23T13:02:11.000Z",
37    "imsi": "668507304809640"
38  },
39  "detail": {
40    "id": 3,
41    "name": "Vodafone",
42    "country": {
43      "id": 74,
44      "name": "Germany",
45      "country_code": "49",
46      "mcc": "262",
47      "iso_code": "de"
48    },
49    "tapcode": [
50      {
51        "id": 2,
52        "tapcode": "DEUD2"
53      }
54    ],
55    "mnc": [
56      {
57        "id": 3,
58        "mnc": "02"
59      }
60    ]
61  }
62}

Purge location

The Purge location event can be sent by the visited or home network to delete all location information for the circuit-switched (CS) domain.

The visited network may send this event if the device is unreachable or switched off for a longer period, indicating to the home network that the device is unavailable.

The home network (emnify) may send this event to delete all information on the visited network, so the device needs a new authentication.

Once executed, the connectivity status appears as Offline in the emnify Portal.

Example: the network deletes the routing information for a mobile-terminated call or mobile-terminated short message and marks the device not reachable.

1{
2  "timestamp": "2021-10-27T10:49:23.673Z",
3  "alert": false,
4  "description": "VLR location information has been purged for IMSI='674828638458881'.",
5  "id": 5993503928,
6  "event_type": {
7    "id": 15,
8    "description": "Purge location"
9  },
10  "event_source": {
11    "id": 0,
12    "description": "Network"
13  },
14  "event_severity": {
15    "id": 0,
16    "description": "Info"
17  },
18  "organisation": {
19    "id": 58617,
20    "name": "Test Org"
21  },
22  "endpoint": {
23    "id": 16292274,
24    "imei": "544699331267254",
25    "ip_address": "88.8.18.46",
26    "name": "Test Sim 2",
27    "tags": null
28  },
29  "sim": {
30    "iccid": "71247175489021804405",
31    "id": 1135076,
32    "production_date": "2020-12-23T13:02:11.000Z"
33  },
34  "imsi": {
35    "id": 8245866,
36    "import_date": "2020-12-23T13:02:11.000Z",
37    "imsi": "674828638458881"
38  }
39}

Purge GPRS location

Similar to the Purge location event, the Purge GPRS location event deletes all state information in the visited or home network but for the packet-switched (PS) domain.

1{
2  "timestamp": "2021-10-24T12:43:51.486Z",
3  "alert": false,
4  "description": "SGSN location information has been purged for IMSI='67282840195069'.",
5  "id": 311518630325,
6  "event_type": {
7    "id": 16,
8    "description": "Purge GPRS location"
9  },
10  "event_source": {
11    "id": 0,
12    "description": "Network"
13  },
14  "event_severity": {
15    "id": 0,
16    "description": "Info"
17  },
18  "organisation": {
19    "id": 4218,
20    "name": "Test Org"
21  },
22  "endpoint": {
23    "id": 11914780,
24    "imei": "796069824764979",
25    "ip_address": "46.127.35.53",
26    "name": "Test Sim 2",
27    "tags": null
28  },
29  "sim": {
30    "iccid": "5061064643679211967",
31    "id": 3686752,
32    "production_date": "2020-12-23T13:02:11.000Z"
33  },
34  "imsi": {
35    "id": 78713389,
36    "import_date": "2020-12-23T13:02:11.000Z",
37    "imsi": "67282840195069"
38  }
39}