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

# Filtering the SIMs pages

> Use filters in the SIMs pages to find exactly the SIMs you are looking for so that you can take action on them quickly or export them for reporting and analysis. Detailed filters are also available in data usage reports for more granular reporting.

<Frame>
  <img src="https://mintcdn.com/hologram-b29df2a6/gBXuuJ66IPyI_nhw/images/sims/sims-filters.webp?fit=max&auto=format&n=gBXuuJ66IPyI_nhw&q=85&s=060fcb114076e53a2831380dd47c37b9" alt="Filters panel" width="2880" height="1566" data-path="images/sims/sims-filters.webp" />
</Frame>

The SIM counts above the table on the SIMs pages show how many SIMs match the active filters, and how many SIMs are selected. If you have selected multiple SIMs, your selections will remain even if the SIMs disappear from view after applying new filters.

<Frame>
  <img src="https://mintcdn.com/hologram-b29df2a6/gBXuuJ66IPyI_nhw/images/sims/sims-multiselect.webp?fit=max&auto=format&n=gBXuuJ66IPyI_nhw&q=85&s=a61f772bd47918f3b3bbb098b60d2c93" alt="Filters applied" width="2483" height="819" data-path="images/sims/sims-multiselect.webp" />
</Frame>

Clear individual or all filters using the buttons at the top of the filters pane or within individual filter sections.

<Info>
  Filters you set are appended to the SIMs page URL so that you can link to and bookmark specific views of your SIMs.
</Info>

## Available filters

<ResponseField name="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.
</ResponseField>

<ResponseField name="SIM IDs">
  Filter by specific SIM IDs within the current view (e.g. `/sims/active`, `/sims/predeployment`, `/sims/deactivated`).
</ResponseField>

<ResponseField name="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                                            |
</ResponseField>

<ResponseField name="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`)
</ResponseField>

<ResponseField name="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.
</ResponseField>

<ResponseField name="Name">
  Filter by SIM name, using a "contains" search.
</ResponseField>

<ResponseField name="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.

  <Note>
    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.
  </Note>
</ResponseField>

<ResponseField name="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.
</ResponseField>

<ResponseField name="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`)
</ResponseField>

<ResponseField name="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`)
</ResponseField>

## 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` |