> 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.

> Data quota management events in the emnify platform

| ID | Description                                         |
| :- | :-------------------------------------------------- |
| 18 | [Quota threshold reached](#quota-threshold-reached) |
| 19 | [Quota used up](#quota-used-up)                     |
| 52 | [Data quota enabled](#data-quota-enabled)           |
| 53 | [Data quota disabled](#data-quota-disabled)         |
| 56 | [Data quota assigned](#data-quota-assigned)         |
| 57 | [Data quota deleted](#data-quota-deleted)           |
| 60 | [Data quota expired](#data-quota-expired)           |

> **API reference**
>
> Quota information is in the event's [detail object](/developers/reference/events#detail-object).

### Quota threshold reached

Remaining data quota volume fell below the configured threshold percentage.
Exclusively for devices with enabled data quota management and a configured quota threshold percentage.

> **Info**
>
> The threshold percentage can be submitted when the data quota is assigned to the device.

**Example**: if the device's data quota volume is set to 100 MB and the threshold percentage to 15%, the system generates an event when the remaining volume falls below 15 MB.

#### Example JSON response

```json maxLines=10
{
    "timestamp": "2021-10-27T09:06:50.000Z",
    "alert": true,
    "description": "Endpoint quota threshold reached, volume is below 80%.",
    "id": 17357540123,
    "event_type": {
        "id": 18,
        "description": "Quota threshold reached"
    },
    "event_source": {
        "id": 1,
        "description": "Policy Control"
    },
    "event_severity": {
        "id": 1,
        "description": "Warn"
    },
    "organisation": {
        "id": 6713,
        "name": "Test Org"
    },
    "endpoint": {
        "id": 86473615,
        "imei": "250642987889789",
        "ip_address": "202.37.156.180",
        "name": "Factory Test Sim 2",
        "tags": null
    },
    "sim": {
        "iccid": "56816736458812006983",
        "id": 1467960,
        "production_date": "2020-12-23T13:02:11.000Z"
    },
    "imsi": {
        "id": 20616184,
        "import_date": "2020-12-23T13:02:11.000Z",
        "imsi": "58834171155367"
    },
    "detail": {
        "quota": {
            "threshold_percentage": 80,
            "threshold_volume": 0.8,
            "volume": -0.00120000000000009
        }
    }
}
```

### Quota used up

Data quota volume is completely depleted.
Exclusively for devices with data quota management enabled.

> **Warning**
>
> Once this happens, the data quota status updates from **Active** to **Exhausted**, and the device won't be able to consume from the data service.
> Established connections for that device disconnects within seconds, and new connection requests are denied until a new data quota is assigned or data quota management is disabled in the service profile.
>
> It's also possible to define an action on **Throttle**.
> This means the device can still use data services with less throughput.

#### Example JSON response

```json maxLines=10
{
    "timestamp": "2021-10-27T09:06:50.000Z",
    "alert": true,
    "description": "Quota volume is completely used up and data access denied for endpoint.",
    "id": 1071715568978,
    "event_type": {
        "id": 19,
        "description": "Quota used up"
    },
    "event_source": {
        "id": 1,
        "description": "Policy Control"
    },
    "event_severity": {
        "id": 1,
        "description": "Warn"
    },
    "organisation": {
        "id": 649,
        "name": "Test Org"
    },
    "endpoint": {
        "id": 19565190,
        "imei": "535561812785483",
        "ip_address": "147.188.3.101",
        "name": "Factory Test Sim 2",
        "tags": null
    },
    "sim": {
        "iccid": "6971715153842702145",
        "id": 28734421,
        "production_date": "2020-12-23T13:02:11.000Z"
    },
    "imsi": {
        "id": 28726038,
        "import_date": "2020-12-23T13:02:11.000Z",
        "imsi": "341399783365891"
    },
    "detail": {
        "quota": {
            "threshold_percentage": 80,
            "threshold_volume": 0.8,
            "volume": "1.000000"
        }
    }
}
```

### Data quota enabled

Data quota management is enabled in a service profile.

> **Warning**
>
> All devices using this service profile need to have an active data quota assigned to use the data service.
> Devices without active data quotas disconnect within seconds.
> New connection requests are denied until a new data quota is assigned or data quota management is disabled in the service profile.

#### Example JSON response

```json maxLines=10
{
  "timestamp": "2022-07-14T13:32:49.046Z",
  "alert": false,
  "description": "Data quota management enabled for service profile (id = 99133 - Generic Service Profile), endpoints of this service profile without an active data quota will be throttled or blocked from data service.",
  "id": 215900319904123,
  "event_type": {
    "id": 52,
    "description": "Data quota enabled"
  },
  "event_source": {
    "id": 2,
    "description": "API"
  },
  "event_severity": {
    "id": 1,
    "description": "Warn"
  },
  "organisation": {
    "id": 9684,
    "name": "Example Org"
  }
}
```

### Data quota disabled

Data quota management is disabled in a service profile.

> **Warning**
>
> There's no longer data service restrictions for devices using this service profile.

#### Example JSON response

```json maxLines=10
{
  "timestamp": "2022-07-14T12:11:41.640Z",
  "alert": false,
  "description": "Data quota management disabled for service profile (id = 99133 - Generic Service Profile).",
  "id": 2990738287492,
  "event_type": {
    "id": 53,
    "description": "Data quota disabled"
  },
  "event_source": {
    "id": 2,
    "description": "API"
  },
  "event_severity": {
    "id": 1,
    "description": "Warn"
  },
  "organisation": {
    "id": 604,
    "name": "Example Org"
  }
}
```

### Data quota assigned

New data quota is assigned to a device.

> **Tip**
>
> Assigning a new data quota to a device is possible at any time.
> [Data quota management must be enabled](#data-quota-enabled) in the service profile.

**Example**: a device has a quota volume of 50 MB with daily auto-refill enabled, valid until May 27, 2025, and action on exhaustion set to block.
The event description reads:
"Data quota got assigned with a volume of 50.000000 MB with daily refill till 2025-05-27T22:56:17Z.
On exhaustion, the data service will be blocked."

#### Example JSON response: action on exhaustion set to block

```json maxLines=10
{
  "timestamp": "2022-07-14T13:35:07.626Z",
  "alert": false,
  "description": "Data quota assigned with volume of 10.000000 MB without daily refill until 2022-07-31T00:00:00Z and action on exhaustion set to blocking.",
  "id": 1028076751946,
  "event_type": {
    "id": 56,
    "description": "Data quota assigned"
  },
  "event_source": {
    "id": 2,
    "description": "API"
  },
  "event_severity": {
    "id": 0,
    "description": "Info"
  },
  "organisation": {
    "id": 2256,
    "name": "Example Org"
  },
  "endpoint": {
    "id": 5293531,
    "imei": "5839369400489068",
    "ip_address": "188.167.183.228",
    "name": "Test Device",
    "tags": null
  },
  "sim": {
    "iccid": "8412861332142732293",
    "id": 935826,
    "production_date": "2017-05-03T20:36:28.000Z"
  },
  "imsi": {
    "id": 186306,
    "import_date": "2017-05-03T20:36:28.000Z",
    "imsi": "175971182377611"
  },
  "detail": {
    "quota": {
      "status": {
        "id": 1,
        "description": "ACTIVE"
      },
      "action_on_exhaustion": {
        "id": 1,
        "description": "Block",
        "peak_throughput": 128000
      },
      "volume": 10,
      "expiryDate": "2022-07-31T00:00:00Z",
      "lastVolumeAdded": 10,
      "lastStatusChangeDate": "2022-07-14T13:35:06Z",
      "autoRefill": false,
      "thresholdPercentage": 10,
      "thresholdVolume": 1
    }
  }
}
```

#### Example JSON response: action on exhaustion set to throttle

```json maxLines=10
{
  "timestamp": "2022-07-14T13:38:11.537Z",
  "alert": false,
  "description": "Data quota assigned with volume of 100.000000 MB without daily refill until 2022-07-14T13:39:00Z and action on exhaustion set to throttling to a throughput of 128 kbit/s.",
  "id": 55632453271862,
  "event_type": {
    "id": 56,
    "description": "Data quota assigned"
  },
  "event_source": {
    "id": 2,
    "description": "API"
  },
  "event_severity": {
    "id": 0,
    "description": "Info"
  },
  "organisation": {
    "id": 2782,
    "name": "Example Org"
  },
  "endpoint": {
    "id": 5477169,
    "imei": "2220624023468711",
    "ip_address": "174.249.170.160",
    "name": "Example Device",
    "tags": null
  },
  "sim": {
    "iccid": "1013367122100019039",
    "id": 899958,
    "production_date": "2017-05-03T20:36:28.000Z"
  },
  "imsi": {
    "id": 943048,
    "import_date": "2017-05-03T20:36:28.000Z",
    "imsi": "209549041950251"
  },
  "detail": {
    "quota": {
      "status": {
        "id": 1,
        "description": "ACTIVE"
      },
      "action_on_exhaustion": {
        "id": 2,
        "description": "Throttle",
        "peak_throughput": 128000
      },
      "volume": 100,
      "expiryDate": "2022-07-14T13:39:00Z",
      "lastVolumeAdded": 100,
      "lastStatusChangeDate": "2022-07-14T13:38:11Z",
      "autoRefill": false,
      "thresholdPercentage": 15,
      "thresholdVolume": 15
    }
  }
}
```

### Data quota deleted

Data quota is deleted from a device.

> **Warning**
>
> Once deleted, devices on this service profile with data quota management enabled won't be able to use the data service.
> Potential data connections of this device disconnect within seconds.
> New connection requests are denied until an active data quota is assigned or data quota management is disabled in the service profile.

#### Example JSON response

```json maxLines=10
{
  "timestamp": "2022-07-14T13:35:18.686Z",
  "alert": false,
  "description": "Data quota deleted.",
  "id": 44285280402507,
  "event_type": {
    "id": 57,
    "description": "Data quota deleted"
  },
  "event_source": {
    "id": 2,
    "description": "API"
  },
  "event_severity": {
    "id": 0,
    "description": "Info"
  },
  "organisation": {
    "id": 7806,
    "name": "Example Org"
  },
  "endpoint": {
    "id": 387316,
    "imei": "9044128511360644",
    "ip_address": "174.238.2.179",
    "name": "Example Device",
    "tags": null
  },
  "sim": {
    "iccid": "7626384783536271949",
    "id": 949644,
    "production_date": "2017-05-03T20:36:28.000Z"
  },
  "imsi": {
    "id": 108458,
    "import_date": "2017-05-03T20:36:28.000Z",
    "imsi": "236366434880861"
  }
}
```

### Data quota expired

Active data quota of a device expired and the quota status changed to **Expired**.
Once expired, the device isn't able to establish a data session.

#### Example JSON response

```json maxLines=10
{
  "timestamp": "2022-07-14T13:39:03.199Z",
  "alert": true,
  "description": "Data quota expired.",
  "id": 35944374073138,
  "event_type": {
    "id": 60,
    "description": "Data quota expired"
  },
  "event_source": {
    "id": 1,
    "description": "Policy Control"
  },
  "event_severity": {
    "id": 1,
    "description": "Warn"
  },
  "organisation": {
    "id": 8238,
    "name": "Example Org"
  },
  "endpoint": {
    "id": 501389,
    "imei": "8134820216492081",
    "ip_address": "227.147.158.142",
    "name": "Example Device",
    "tags": null
  },
  "sim": {
    "iccid": "3694452932824047676",
    "id": 103965,
    "production_date": "2017-05-03T20:36:28.000Z"
  },
  "imsi": {
    "id": 357765,
    "import_date": "2017-05-03T20:36:28.000Z",
    "imsi": "29821710188733"
  }
}
```