Skip to main content
A data usage limit defines the total amount of data the device can consume during a billing period. When a SIM reaches the limit you set, its data usage is paused. The organization’s owner will also get an email notifying them of the pause. Data usage limits are checked at the close of each data session. If the SIM’s data plan has included data, the data limit has a minimum value of that included data. This value is the overagelimit parameter returned in the REST API, and is checked above plan included data amounts. We recommend pausing SIMs at 10 GB to protect against runaway data usage from theft or device misconfiguration. You can also leave a SIM unlimited or set a custom amount.
Warning: You cannot set a 0 B data usage limit on a data plan that does not include data. A 0 B limit would pause the SIM at the first data usage of the billing period. If a SIM already has a 0 B limit, the form will not pre-fill that value.

​
How to set a limit for a single SIM

  1. Open a SIM from the SIMs pages or using global search.
  2. Click the Manage SIM menu in the header and choose Set data usage limits.
  3. Choose a limit:
    • Pause at 10 GB (recommended)
    • Unlimited
    • Custom amount in KB/MB/GB
  4. Confirm the update.

​
How to set usage limits in bulk

You can set data usage limits for any number of SIMs. Updates are written in batches of 2,000 SIMs, and the modal shows progress while the update runs. If the SIMs you selected have data limits set to the same value, the modal shows that limit for context. This check will work for up to 500 SIMs. If SIMs are on data plans with different included data amounts, will need to update SIMs on each plan individually.
  1. Navigate to the SIMs section in your dashboard.
  2. Use filters and sorting to find and select the SIMs you want to update.
  3. Open the Manage SIMs menu and choose Set data usage limits.
  4. Choose Pause at 10 GB, Unlimited, or a custom amount.
  5. Review and apply the changes.
Note: If an update only succeeds for some of the selected SIMs, the modal stays open, reports how many SIMs were updated, and refreshes those SIMs in inventory so you can retry the rest. Success messages name the SIMs that were updated.

​
How to set usage limits using the REST API

Update data limits (bulk)

Update SIM data usage limits in bulk POST /devices/usagelimit

Update data limits (async batch)

Create a batch job to update SIM data usage limits POST /devices/batch/usagelimit
Note: Set overagelimit in bytes; use -1 for unlimited. Optional fields include datathreshold (alert only) and smslimit.

​
Subscribing to data usage limit events

SIMs that reach a data usage limit will create an event in the Event monitoring section of your dashboard. You can subscribe to these events to receive email or webhook notifications when a SIM’s data usage limit is reached using Alerts.

​
Why did my SIM pause before or after my exact limit?

Data usage limits are checked at the close of each data session, not continuously during a session. Your SIM reports its usage when a session ends, and Hologram pauses the SIM if that total has reached or exceeded your limit. Because of this, the pause happens at a session boundary rather than at the exact byte:
  • If a session pushes cumulative usage past your limit, the SIM pauses when that session closes — so a SIM can use somewhat more than the limit within a single long session before pausing.
  • A SIM can also appear to pause slightly below a round number, because the limit was reached partway through a session and enforced at the next session close.
When a limit pauses a SIM, it moves to the Paused by system status. To resume it, raise or remove the limit — usage restarts automatically. See what causes the “Paused by system” status. In addition, data usage limits are checked against the SIM’s 30-day billing period that began on the day it was activated (making it an Active SIM). If you have monthly invoicing, this may not align with monthly billing periods for your organization, leading to data limit enforcement behavior that doesn’t exactly match what you see in your dashboard.

Set data warning thresholds

Set a data warning threshold for your SIMs to receive notifications when a certain amount of data is reached.

Pause or resume SIMs

Pause or resume SIMs to prevent or allow data usage.

Change data plans

Change data plans for your SIMs.