For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Request featuresContact support
    • Welcome
  • Quickstart
    • Sign up for an account
    • emnify Trial plan
    • Order and auto-register SIMs
    • Register SIMs
    • Create a device
    • Configure the APN
    • emnify REST API
    • Troubleshooting
  • Services
      • Data Streamer
      • Events
        • Event types
          • Generic events
          • Network attachment and location
          • Data connection lifecycle
          • Application and user authentication
          • User management
          • Device status management
          • Limit enforcement
          • Data quota management
          • SMS quota management
          • Cloud Connect lifecycle
          • OpenVPN lifecycle
          • Organization and billing
        • Work with system events
      • Security
    • Support
LogoLogo
Request featuresContact support
On this page
  • Create PDP Context
  • Delete PDP Context
ServicesPlatformEventsEvent types

Data connection lifecycle

Was this page helpful?

Last updated July 15, 2025

Previous

Network attachment and location

Next

Application and user authentication

Built with
IDDescription
3Create PDP Context
5Delete PDP Context

Create PDP Context

A Packet Data Protocol (PDP) context allows UE to exchange IP packets over the network.

A Create PDP Context event indicates the activation of data connectivity.

Example: a device has established a data session and started transferring data. This device appears as Online in the emnify Portal as long as there hasn’t been a subsequent Delete PDP Context event.

Example JSON response: create PDP context accepted
1{
2 "timestamp": "2021-10-27T08:38:02.000Z",
3 "alert": false,
4 "description": "New PDP Context successfully activated with SGSN CP=60.195.159.61, DP=117.72.59.30.",
5 "id": 31877325941,
6 "event_type": {
7 "id": 3,
8 "description": "Create PDP Context"
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": 1825,
20 "name": "Test Org"
21 },
22 "endpoint": {
23 "id": 20200078,
24 "imei": "960407272413998",
25 "ip_address": "189.79.243.228",
26 "name": "Test Sim 2",
27 "tags": null
28 },
29 "sim": {
30 "iccid": "5746435358418205328",
31 "id": 646486,
32 "production_date": "2020-12-23T13:02:11.000Z"
33 },
34 "imsi": {
35 "id": 12105613,
36 "import_date": "2020-12-23T13:02:11.000Z",
37 "imsi": "693601932595201"
38 },
39 "detail": {
40 "country": {
41 "mcc": "262",
42 "name": "Germany",
43 "country_code": "49",
44 "iso_code": "de",
45 "id": 74
46 },
47 "id": 3,
48 "session_id": "d12c574f-e219-45a4-8836-d17a50f66fb1",
49 "pdp_context": {
50 "breakout_ip": "97.106.216.29",
51 "rac": null,
52 "sgsn_control_plane_ip_address": "117.72.59.30",
53 "rat_type": 2,
54 "tx_teid_data_plane": 557727595,
55 "region": "eu-west-1",
56 "apn": "em",
57 "tx_teid_control_plane": 570842943,
58 "tunnel_created": "2021-10-27T08:38:02",
59 "ggsn_data_plane_ip_address": "150.85.110.76",
60 "sgsn_data_plane_ip_address": "223.253.0.120",
61 "rx_teid": 96601675,
62 "ci": 5174,
63 "imsi": "82186563190127",
64 "lac": 921,
65 "mcc": "262",
66 "sac": null,
67 "ggsn_control_plane_ip_address": "60.195.159.61",
68 "mnc": "02",
69 "nsapi": 5,
70 "ue_ip_address": "101.124.109.214",
71 "imeisv": "6887426203768011",
72 "pdp_context_id": 51755555,
73 "gtp_version": 1,
74 "operator_id": "3",
75 "tariff_profile_id": "395978", // coverage policy
76 "ratezone_id": "8178", // coverage area
77 "tariff_id": "555" // data plan
78 },
79 "name": "Vodafone"
80 }
81}
Example JSON response: create PDP context rejected because data service is disabled in the service profile
1{
2 "timestamp": "2021-10-24T12:43:51.000Z",
3 "alert": true,
4 "description": "PDP Context Request rejected, because data service disabled in service profile.",
5 "id": 2836707022,
6 "event_type": {
7 "id": 3,
8 "description": "Create PDP Context"
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": 1222,
20 "name": "Test Org"
21 },
22 "endpoint": {
23 "id": 14002489,
24 "imei": "211785743231328",
25 "ip_address": "173.97.253.42",
26 "name": "Test Sim 2",
27 "tags": null
28 },
29 "sim": {
30 "iccid": "41595256071723032296",
31 "id": 801148,
32 "production_date": "2020-12-23T13:02:11.000Z"
33 },
34 "imsi": {
35 "id": 62004293,
36 "import_date": "2020-12-23T13:02:11.000Z",
37 "imsi": "175904061168404"
38 }
39}
Example JSON response: create PDP context rejected because the device doesn't have a quota
1{
2 "timestamp": "2021-10-27T08:55:59.000Z",
3 "alert": true,
4 "description": "PDP Context Request rejected, because endpoint has no quota.",
5 "id": 7745432124,
6 "event_type": {
7 "id": 3,
8 "description": "Create PDP Context"
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": 177,
20 "name": "Test Org"
21 },
22 "endpoint": {
23 "id": 10238,
24 "imei": "127957062642784",
25 "ip_address": "113.252.159.78",
26 "name": "Test Sim 2",
27 "tags": null
28 },
29 "sim": {
30 "iccid": "6300267938152764468",
31 "id": 3012262,
32 "production_date": "2020-12-23T13:02:11.000Z"
33 },
34 "imsi": {
35 "id": 66367669,
36 "import_date": "2020-12-23T13:02:11.000Z",
37 "imsi": "85785128232645"
38 }
39}
Example JSON response: create PDP Context Request rejected because the device's quota volume is exhausted, and the defined action is to block data traffic
1{
2 "timestamp": "2021-10-27T09:12:27.000Z",
3 "alert": true,
4 "description": "PDP Context Request rejected, because quota volume of endpoint is exhausted and defined action is to block data traffic.",
5 "id": 7598008306,
6 "event_type": {
7 "id": 3,
8 "description": "Create PDP Context"
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": 8087,
20 "name": "Test Org"
21 },
22 "endpoint": {
23 "id": 39063467,
24 "imei": "454208457191395",
25 "ip_address": "120.133.145.19",
26 "name": "Test Sim 2",
27 "tags": null
28 },
29 "sim": {
30 "iccid": "91447762462599458698",
31 "id": 609020,
32 "production_date": "2020-12-23T13:02:11.000Z"
33 },
34 "imsi": {
35 "id": 97534929,
36 "import_date": "2020-12-23T13:02:11.000Z",
37 "imsi": "715343715967543"
38 }
39}
Example JSON response: create PDP context request rejected because the SIM isn't activated
1{
2 "timestamp": "2021-10-27T12:33:17.000Z",
3 "alert": true,
4 "description": "PDP Context Request rejected, because SIM is not activated.",
5 "id": 117138486882,
6 "event_type": {
7 "id": 3,
8 "description": "Create PDP Context"
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": 4823,
20 "name": "Test Org"
21 },
22 "endpoint": {
23 "id": 1257319,
24 "imei": "25631320011492911",
25 "ip_address": "230.105.77.310",
26 "name": "Test Sim 2",
27 "tags": null
28 },
29 "sim": {
30 "iccid": "87901100765269508687",
31 "id": 45142,
32 "production_date": "2020-12-23T13:02:11.000Z"
33 },
34 "imsi": {
35 "id": 497998,
36 "import_date": "2020-12-23T13:02:11.000Z",
37 "imsi": "76604441813689"
38 }
39}

Delete PDP Context

Data session between the device and the network is deleted.

Example: a device disconnected and ended a data transfer. The event details also show the data transmitted, and the device appears as Attached in the emnify Portal.

Example JSON response
1{
2 "timestamp": "2021-10-27T08:40:10.000Z",
3 "alert": false,
4 "description": "PDP Context deleted.",
5 "id": 1906081382592,
6 "event_type": {
7 "id": 5,
8 "description": "Delete PDP Context"
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": 39089,
20 "name": "Test Org"
21 },
22 "endpoint": {
23 "id": 8163445,
24 "imei": "82586199276110710",
25 "ip_address": "104.86.8.106",
26 "name": "Test Sim 2",
27 "tags": null
28 },
29 "sim": {
30 "iccid": "9335742231782809262",
31 "id": 1931060,
32 "production_date": "2020-12-23T13:02:11.000Z"
33 },
34 "imsi": {
35 "id": 5216225,
36 "import_date": "2020-12-23T13:02:11.000Z",
37 "imsi": "49652622520507"
38 },
39 "detail": {
40 "country": {
41 "country_code": "49",
42 "mcc": "262",
43 "name": "Germany",
44 "iso_code": "de",
45 "id": 82
46 },
47 "volume": {
48 "total": 0.641984,
49 "rx": 0.418811,
50 "tx": 0.223173
51 },
52 "id": 3,
53 "session_id": "2a4ff039-fbb9-4eaa-b74c-2f0eaafaf624",
54 "pdp_context": {
55 "breakout_ip": null,
56 "rac": null,
57 "sgsn_control_plane_ip_address": "234.39.123.228",
58 "rat_type": 2,
59 "tx_teid_data_plane": 966839357,
60 "region": "eu-west-1",
61 "apn": null,
62 "tx_teid_control_plane": 397629956,
63 "tunnel_created": "2021-10-27T08:38:02",
64 "ggsn_data_plane_ip_address": "225.129.61.136",
65 "sgsn_data_plane_ip_address": "173.69.12.45",
66 "rx_teid": 18195957,
67 "ci": 6471,
68 "imsi": "369573775632443",
69 "lac": 767,
70 "mcc": "262",
71 "sac": null,
72 "ggsn_control_plane_ip_address": "67.185.18.116",
73 "mnc": "02",
74 "nsapi": 5,
75 "ue_ip_address": "66.185.97.229",
76 "imeisv": "4555797980633712",
77 "pdp_context_id": 79790039,
78 "gtp_version": 1
79 },
80 "name": "Vodafone"
81 }
82}