Skip to main content

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.

May 20, 2026
Product update

What’s new

  • Legacy and deprecated data plans are now more labeled so that you can take action and move to plans with better pricing or coverage.
    • To change data plans for a SIM, click the SIM count for a plan, select your SIMs in the SIMs page, and use the Manage SIMs menu to Change plans.
  • Data limits are now recommended for all SIMs. We recommend a minimum limit of 10 GB to protect against runaway data usage from theft or device misconfiguration. When activating SIMs or changing data plans, you will now have better options for selecting data limits.
  • Data plans now display the plan type in the Plan details page header. Hologram standard plans use our standard rates. Custom plans are plans for contracted organizations with negotiated rates.

What’s fixed

  • Deprecated data plans are now listed in the Data Plans page along with messaging about how to take action.
  • The Activation button on the Home page is hidden for users without activation permissions.
  • The Hologram brand blue color for interactive elements has been adjusted to match upcoming website changes.
May 18, 2026
Product updateDocumentation

What’s new

  • Simulate message to API functionality is no longer available to new organizations, and has been restricted to organizations that have used it in the past year.

What’s improved

  • Entering a device ID when creating an Alert now verifies the device ID as expected after the field loses focus. Better validation messages have been a dded to the field.
  • Alerts that are no longer supported now show the full description to make it clearer what is no longer working.

What’s fixed

  • First IMEI alerts can now be created and events filtered as expected.
  • Organizations generating events through the SIM socket API can now manage Events and Alerts as expected. This functionality is still supported, but is now considered a legacy feature.
  • Alerts that are no longer supported can now be disabled instead of only deleted.
May 14, 2026
Product updateAPI

What’s improved

  • Overall API performance has been improved across both direct API usage and your dashboard.
  • Long-running pending tasks that appear in the top menu now link to support and next steps.

What’s fixed

  • Event monitoring and filtered event loading times are significantly faster and can now handle any size fleet.
  • Profile descriptions for multi-core SIMs in a single SIM’s Profiles tab now display the correct descriptions in all cases. SIMs with Outage Protection would incorrectly describe some profiles as requiring a manual change.

Known issues

  • First IMEI events are still being created correctly, but are not displaying correctly in Event monitoring or Alerts and should be fixed in the next release. Alerts created for first IMEI events may not trigger correctly.
May 13, 2026
Product updateDocumentation

What’s new

  • The Hologram socket API is no longer supported.
  • Events and alerts with the tags _JSONSTRING_, _SOCKETAPI_ , _SIMPLESTRING_ should be considered deprecated and will be marked with warnings in a future release.

What’s improved

  • Data plans in activation for contracted organizations are categorized as standard vs custom plans in activation to match the Data Plans page
  • Plan SIM counts in Activation have been reverted to the pre-v3.2.0 style.

What’s fixed

  • Contracted organizations activating SIMs that had coverage on Hologram standard plans but not on custom data plans with negotiated rates would not see any options for navigation. Standard plans now display as expected with warning notes.
May 12, 2026
Product update

What’s fixed

  • The Data usage thresholds bulk action no longer shows a duplicate message about Alerts integration.
  • The Invoices page would display an error in a specific configuration before an invoice was published.
May 7, 2026
Product update

What’s improved

  • Organizations with custom data plans now see more explicit messaging for Hologram standard plans during Activation and in the Data plans screen. These data plans may be more expensive than plans with negotiated rates, and we’re trying to make it easier to identify when SIMs may be unintentionally activated onto the wrong plan.

What’s fixed

  • Bookmarks to certain URLs from the previous dashboard version now redirect to the correct pages.
  • Changing data plans would not work in specific cases when a SIM was on an inactivated data plan and only had one new plan it could change to.
  • Credit card warnings for organizations with monthly invoicing have been fixed and no longer prevent SIM activation.
  • Descriptions in the update data limit bulk action have been fixed for prepaid organizations.

Known issues

  • Standard plan warnings are not yet available when viewing a single SIM.
May 5, 2026
API

What’s fixed

  • Network-level billing rates for a single SIM now display correctly if the SIM has multiple installed profiles.
May 4, 2026
Product updateAPIDocumentationReporting

What’s new in Hologram v3.0

What’s new

  • Reorganized main menu with clearer labels and better state management.
  • A redesigned Organization switcher in the top-left corner makes it easier to see which org you’re in and switch between them.
  • More pending actions appear in the Pending tasks dropdown, including plan changes and SIM configuration EUICC operations.
  • The Support menu in the top bar gives you quick access to integrated documentation, uptime status, and links to contact support or share feedback.

What’s fixed

  • Empty states have been added to more pages, with better descriptions.

SIMs pages

What’s new

  • A new Data usage tab now displays for smaller organizations, with access to the current month and last 3 calendar months of data usage. This tab should load more quickly for most organizations with most of the commonly asked questions. Organizations with an active contract or over $100 USD of monthly charges have access to full historical data usage.
  • A new Alerts tab displays all alerts active for a specific SIM. Alerts will display in this tab if the alert is subscribed to the SIM, or a tag applied to the SIM.
  • A new Events tab displays all events that have been created for this SIM.

What’s improved

  • Data usage threshold labels in the Pricing tab have been clarified — they no longer use “alerts” language, since they don’t [yet] send notifications.
  • The Webhooks tab in SIM details now links to the correct section of the documentation.

Activation and Change plan

What’s new

  • The new Activation workflow has clearer steps, better data plan information, improved validation, and stronger awareness of which SIMs are being activated. It’s more reliable, faster, and easier to use.
  • Change plan now supports more SIMs at once and better explains coverage limitations or errors when SIMs are in different configurations.
  • Data limit selection more clearly describes what will happen when multiple SIMs are selected. In the Change plan workflow, you can now choose to reset, keep, or update existing data limits.

What’s improved

  • Change Plan shows a clearer warning when there are no other plans available to switch to.
  • Data plan filtering in Activation and Change plan is now correct — plans only appear if all profiles on a SIM match, not just the first profile.
  • The Pay and Activate step has clearer labeling for totals and charges.
  • The Auto-refill card in activation is now clearer and is hidden if auto-refill is already configured.
  • The usage alert threshold toggle more clearly explains how the feature works.

Data plans and coverage

Updates released in April.

What’s new

  • The Data plans page has been reworked to show every plan available to your organization, organized by type:
    • Pay-as-you-go plans
    • Included data plans
    • Data pools (fixed size and dynamic)
  • Custom data plans with negotiated rates are now separated from Standard data plans for organizations with an active contract.
  • Standard data plans without any assigned SIMs are hidden by default — you can show them with a toggle.
  • Pre-deployment SIM counts are now shown for organizations with Test Mode access, and clicking the count filters the SIMs page to that group.

What’s improved

  • Coverage Explorer now explains more clearly how profiles affect coverage.
  • Coverage Explorer filtering has been improved — it now shows only the coverage available to selected SIMs in Activation and Change plan workflows. Filtering by a profile also filters network and country counts to make actual SIM coverage clearer.

Alerts and event monitoring

What’s new

  • Alerts lets you subscribe to Events created for SIMs, and send email or webhook notifications when those events occur. You can create alerts for:
    • Data usage limits reached
    • IMEI and IMEI TAC changes
    • First IMEI recognized
    • SMS and cloud messages
    • Conductor EUICC SIM configuration events
  • The Event history page replaces the old activity drawer at the bottom of the dashboard. All events can be found in this page, and filtered views by SIMs can be found in a SIM’s Events tab.
  • You can now add SIM alerts directly from the Manage SIM button on a SIM’s details page, and from the SIM’s Alerts tab.
  • Inflight and data usage threshold tracking has been migrated into Dashboard Next as Fleet events, accessible from the Home page or under Event monitoring in the main menu. This is a temporary migration and will be rolled into Alerts soon.

What’s improved

  • Event tags display real labels — event names, SIM names, and tag labels show real names instead of internal _EVENT_TAG_ formatting.
  • Event History and SIM Events tables have cleaner row styles, smaller tags, and reduced horizontal space for easier scanning.
  • Alerts search field now includes a close button when filled, so it’s clear when a search is active.

What’s fixed

  • Events now correctly display errors in the Event history and SIM Events pages.
  • The Event details modal wraps event data and raw message contents in a code block, and hides the Alerts Triggered field when it’s empty.
  • Creating an alert with a device ID now trims whitespace from entered IDs.
  • SMS notification methods for alerts have been removed (this functionality relied on SMS over IP, which Hologram deprecated in 2023).
  • The unused Usage alerts tab has been removed from the Alerts page.
  • SMS alerts can no longer be edited, as intended.

Billing and transactions

What’s new

  • A new Transaction history report with sorting, filtering, and more powerful export capabilities.
    • Organizations with under $100 USD in monthly charges will see a separate report with detailed transaction information categorized by type.
  • Clicking the total charges amount on the Invoices or Balance history page now links to a filtered view of Transaction history.
  • A new invoice email recipients section on the Billing Account page explains how invoice notifications work.

What’s improved

  • Auto-refill settings have been merged with Account Balance on the Billing Account page to make how it works and how to configure it clearer.
  • Balance subtotals (pending transactions and promo credits) now only appear when they actually apply to your account balance.
  • Transactions history shows a more descriptive error state if your organization has no historic transactions.
  • Credit card receipts can now be found in the Receipts section of the main menu if your organization is prepaid, or within the Invoices section if your organization has monthly invoicing.
  • Totals are now consistently labeled across screens.

What’s fixed

  • A crash in the Transactions page for organizations that had changed billing methods in specific combinations.
  • The Balance History and Transactions pages no longer crash for organizations with a misconfigured invoice missing a billing period.

Account and organization settings

What’s new

  • The Settings pages have been consolidated into three tabs:
    • This organization — org details, team members, and invites.
    • My account — your user details and your API keys.
    • My organizations — all org memberships and pending invitations.
  • The Team tab (previously called “Users”) has the invite button moved into the header for better visibility.
  • A Pending invitations button appears in the Settings header when you have outstanding invites.

What’s improved

  • Organization users are now sorted by role, with the current user and org owner at the top.
  • A Pending invitations button now appears in the Settings header when you have outstanding invites.
  • The My Account page has been laid out more clearly with better labeling.
  • The API key card has been moved to the My Account tab and has better copy behavior and error handling, and is no longer visible to Editor Limited roles that can’t access the API.
  • The Organizations tab explains how to switch organizations from the org panel.
  • New accounts now get more graceful email verification prompts when first logging in or accepting invitations.

What’s fixed

  • The Pending invitations card is no longer visible to Editor Limited users who shouldn’t have access.

Home page

What’s new

  • The Welcome page now correctly hides the Activation button and getting-started guides for Editor and Editor Limited roles.
  • The Home page now has an activation button and has an count of all active SIMs that aren’t included in the summary totals.

What’s improved

  • The Home page now lists times in UTC to match the rest of Hologram’s systems.
  • Tooltips have been updated for clarity.

Documentation

What’s new

  • Documentation has been updated with new details and screenshots for all the updates made in v3.0.
  • Open documentation for any feature from the Support menu in the top navigation bar.

API

What’s new

  • Conductor SIM configuration endpoints are now available for organizations with early access.

What’s improved

  • Additional descriptions and clarifications have been added to REST API endpoint documentation, with more to come.

Known issues

  • Fixed in API update on 2026-05-05. The Coverage tab for individual SIMs can show incorrect rates if 1) the plan is network-level billed, 2) the SIM has multiple profiles installed, and 3) the SIM’s other profiles have negotiated rates.
  • Some pages are still not optimized well for smaller screens.
  • We are working on performance enhancements to our detailed historical data usage reports.
  • There are some known phone number permission mismatches in the UI and API.
  • The billing address form has issues with some specific countries.
April 16, 2026
Product updateDocumentation

What’s fixed

  • Current month transaction totals would not display correctly in the Transactions page for organizations with standard billing.
  • Missing parameters and descriptions have been added to the REST API documentation for some of the /devices and /usage endpoints.
April 8, 2026
Product updateDocumentation

What’s new

  • A new color palette in your dashboard matching upcoming Hologram brand updates.

What’s fixed

  • A crash in the transactions page for organizations that had changed billing methods has been fixed.
  • The Recent invoices card in the Account page no longer displays for prepaid orgs that used to be postpaid.
  • REST API documentation labels once again display correctly after a bug was identified in our documentation tooling and reported to our vendor.

What’s improved

  • Totals on the Balance balance history and Transactions pages now include “+/-” labeling for all values.
March 19, 2026
Product update

What’s fixed

  • Fixed a configuration issue that could crash the Balance History and Transactions pages for organizations with monthly invoicing.
March 18, 2026
Product update

What’s fixed

  • The Billing section once again displays the correct page configuration for organizations with custom billing.
March 16, 2026
Product update

What’s new

  • Balance History replaces the old Statements page, with filtered links to our new Transaction history page.
  • Clicking the total charges amount on the Invoices page now links to a filtered view of Transaction history.
  • Transactions history has been updated to a new report with sorting, filtering, and more powerful export capabilities.
  • Coverage explorer filtering has been improved, displaying only the coverage available to selected SIMs in Activation and Change plan workflows. Filtering by a profile will now also filter network and country counts to make actual SIM coverage clearer.

What’s improved

  • Data usage reports now display a more descriptive error state if an organization has no historic data usage.
  • The Orders page now uses “Credit card receipts” labeling to clarify how it actually works.
  • Simulate message has a new icon distinct from send message.
  • Transactions history now displays a more descriptive error state if an organization has no historic data usage or transactions.

What’s fixed

  • Available rate ranges displayed across SIMs and data plans will no longer fall out of sync if coverage explorer network lists fall behind available data usage rates.

Known issues

  • Fixed in v3.1.0 If your organization has custom billing, Transaction reports are still sent by your account team.
March 10, 2026
Product update

What’s new

  • Data plans with network-level billing now display rate ranges in your dashboard.
March 4, 2026
Product update

What’s new

  • The single SIM’s Pricing tab now displays variable rate ranges for network-level billing plans.
  • The single SIM’s Pricing tab now supports dynamic data pools.

What’s improved

  • The Profiles tab for a single SIM identifies target fallback profiles for SIMs with Outage Protection.
  • The Profiles tab for a single SIM now labels profiles that can’t be switched to manually because of unsupported profile states.

What’s fixed

  • Coverage explorer for SIMs and Plans returns correct rate ranges in all cases and for all billing configurations.
  • Coverage explorer excludes additional installed profiles that can’t use data for SIMs without fallback enabled.
March 4, 2026
Product update

What’s fixed

  • The Pending bulk actions button in the top navigation correctly links to Activity History.
  • Connected, active SIM status counts on the Home page no longer include pre-deployment SIMs.

Known issues

  • Fixed in v2.14.1 We are aware of some visual display issues with the Data plans and Coverage pages that will be fixed in an upcoming release.
March 3, 2026
Documentation

What’s new

  • Our datasheets have been updated to note that data retention for Hyper SIMs is rated for 20 years at 20°C.
March 2, 2026
Product update

What’s fixed

  • The Pending bulk actions button in the top navigation correctly links to Activity History.
  • Connected, active SIM status counts on the Home page no longer include pre-deployment SIMs.

Known issues

  • Fixed in v2.14.1 We are aware of some visual display issues with the Data plans and Coverage pages that will be fixed in an upcoming release.
February 19, 2026
Product update

What’s fixed

  • SIMs pages were sometimes displaying SIM statuses incorrectly as “Pending” even if the SIM was in a different status and network state.

Known issues

  • Connected SIM status counts on the Home page include both Active and Pre-deployment SIMs.
February 10, 2026
Product update

What’s improved

  • The Activate SIMs button now does not display instead of displaying errors if users do not have access, and has been removed from the Deactivate SIMs page.
  • The Set APN confirmation modal that appears after activation now clarifies that device Data Roaming needs to be enabled.
  • Labels and descriptions for data usage thresholds have been clarified to remove “alerts” language since they cannot send notifications.
  • Coverage Explorer now has a clearer explanation of how profiles affect coverage.

What’s fixed

  • Data plan names no longer display in the SIMs pages for Editor Limited roles.
  • Long data plan names now display as expected in a SIM’s Pricing tab.
  • Data limits displayed in a SIM’s Pricing tab are now precise, and do not round up.
  • The Transfer SIMs bulk action now properly deselects transferred SIMs after transfer.
  • The My account → API tab is now hidden for roles without API access.
  • Data usage thresholds set to 0 now display in a SIM’s Pricing tab as expected. Limited access functionality.
  • A number of small visual improvements and bug fixes.
February 4, 2026
API

What’s fixed

  • The Single SIM data usage report correctly defaults to the SIM’s current billing period.
January 30, 2026
API

What’s new

  • Variable data plan rates are now available in your dashboard when viewing a data plan, a SIM’s pricing tab, activating SIMs, and changing data plans.

Known issues

  • Fixed in v2.14.2 Variable data plan rates are not yet accurately displayed in Coverage Explorer, but are planned for release in February, 2026.
  • Fixed in reporting update on 2026-02-04 The Single SIM data usage report does not default to the SIM’s current billing period in all cases.
January 29, 2026
API

What’s improved

  • Data usage limits are no longer removed from SIMs when changing data plans, provided the source data plan and target data plan have the same included data amount. Switching between pay as you go plans will now never remove data usage limits.
January 22, 2026
Product update

What’s fixed

  • SIM count links on the Data plans pages now correctly link to a filtered view of the SIMs pages.
January 13, 2026
Product update
v2.13.1

What’s fixed

  • Switch Profiles no longer allows profile changes when profiles are in unsupported profile states like ASSIGNED.
January 8, 2026
API

Known issues

  • The /devices GET endpoint does not return location data for the lastsession property. Endpoint documentation has been updated to remove location data from the lastsession property, which right now is only returned for the single SIM endpoint.