Documentation Index
Fetch the complete documentation index at: https://docs.hologram.io/llms.txt
Use this file to discover all available pages before exploring further.
Filters you set are appended to the SIMs page URL so that you can link to and bookmark specific views of your SIMs.
Available filters
Tags
Filter by all tags created in your organization, even if no SIMs in the current view have that tag applied.Tags can be added, edited, or deleted using the Manage SIMs dropdown or by visiting the Tags page.
SIM IDs
Filter by specific SIM IDs within the current view (e.g.
/sims/active, /sims/predeployment, /sims/deactivated).SIM status
Filter by available SIM statuses for the current view, even if no SIMs currently have that status.
| View | Statuses |
|---|---|
| Pre-deployment | In testing/Connected, Available, Entering testing, Ready to activate |
| Active | Ready/Connected, Pending, Pausing, Paused by user, Paused by system |
| Deactivated | Deactivating, Deactivated |
Last active
Filter SIMs by the end of their last closed session. Enter a custom timeframe, or select a preset range to pre-fill the filter.
- Start date selects midnight UTC for the selected date (e.g.
12-01-2024 00:00:00.999) - End date selects 1ms before midnight UTC for the selected date (e.g.
12-01-2024 23:59:59.999)
ICCID
Filter SIMs by ICCID of a SIM’s currently enabled profile — the profile currently able to use data — and the initially installed bootstrap profile. The bootstrap profile is printed on triple cut 4FF SIM cards.The filter defaults to Contains but can be refined to: Contains, Equals, Starts with, or Ends with. “Contains” will always find full ICCIDs — there are no performance differences between the methods.
Name
Filter by SIM name, using a “contains” search.
Last known IMEI
Filter by the last known device IMEI for a SIM, if provided by a carrier and network. The default “Contains” filter will show IMEIs that match the entered IMEI exactly and is exactly as fast as the “Is” filter.
SIMs may not have an associated IMEI if they have not been activated and connected to a network. Certain networks do not return IMEI for every session.
Data plan
Filter by all data plans available to your organization. If you have a contracted account with Hologram, data plans with negotiated rates display at the top of the list.
Activation date
Active and Deactivated SIMs views only.Filter SIMs by the date they were activated and were able to begin using data. Enter a custom timeframe, or select a preset range to pre-fill the filter.
- Start date selects midnight UTC for the selected date (e.g.
12-01-2024 00:00:00.999) - End date selects 1ms before midnight UTC for the selected date (e.g.
12-01-2024 23:59:59.999)
Target activation date
Pre-deployment SIMs view only.Filter SIMs by the date they will automatically be activated if they don’t use their test data. Enter a custom timeframe, or select a preset range to pre-fill the filter.
- Start date selects midnight UTC for the selected date (e.g.
12-01-2024 00:00:00.999) - End date selects 1ms before midnight UTC for the selected date (e.g.
12-01-2024 23:59:59.999)
URL filter parameters
Filter parameters can be combined. For multiple values, use a comma-separated list.| Filter | URL parameter | Notes |
|---|---|---|
| Views | /sims/active, /sims/predeployment, /sims/deactivated | |
| SIM IDs | ?hologramSimIds=SIMID,SIMID | Filter is per view. A deactivated SIM will not be displayed in the active or pre-deployment views. |
| Tags | ?tags=TAGID,TAGID | There is currently no way to filter on SIMs with no tags. |
| SIM status | ?simStatuses=Ready,Pending,Pausing,Paused_by_user,Paused_by_system | Spaces in status names are replaced by underscores. |
| ICCID | ?iccid-condition=contains&iccid-value=VALUE | Conditions: contains, endswith, startswith, is |
| Last active | ?lastActive-timeframe=custom&lastActive-start=MM-DD-YYYY&lastActive-end=MM-DD-YYYY | Start and end dates are required. If timeframe doesn’t match start and end dates the filter will not be applied. Timeframes: custom, thisMonth, P7D, P30D, P90D, P365D |
| Name | ?deviceName=NAME | |
| Last known IMEI | ?imei-condition=contains&imei-value=VALUE | Conditions: contains, endswith, startswith, is |
| Data plans | ?plan=DATAPLANID,DATAPLANID | |
| Activation date | ?activationDate-timeframe=custom&activationDate-start=MM-DD-YYYY&activationDate-end=MM-DD-YYYY | Start and end dates are required. If timeframe doesn’t match start and end dates the filter will not be applied. Timeframes: custom, thisMonth, P7D, P30D, P90D, P365D |
| Target activation date | ?targetActivationDate-timeframe=custom&targetActivationDate-start=MM-DD-YYYY&targetActivationDate-end=MM-DD-YYYY | Start and end dates are required. If timeframe doesn’t match start and end dates the filter will not be applied. Timeframes: custom, thisMonth, P7D, P30D, P90D, P365D |