# Hologram Documentation - [Get connected with Hologram](https://docs.hologram.io/index.md): Hologram is a global IoT cellular connectivity provider with outage-proof global SIMs, best-in-class tools for managing your fleets, data insights for IoT devices, and APIs to integrate with your applications. Get help activating SIMs, using the platform, managing your SIMs and devices, troubleshoot… - [Get started with Hologram and connect your devices](https://docs.hologram.io/guides/get-started/get-started-with-hologram.md) - [Set up your device to use a Hologram SIM](https://docs.hologram.io/guides/get-started/set-up-your-device-to-use-a-hologram-sim.md) - [SIM connectivity overview](https://docs.hologram.io/guides/get-started/sim-connectivity-overview.md) - [Activate SIMs in the Hologram Dashboard](https://docs.hologram.io/guides/get-started/activate-your-first-sims.md) - [Set the device APN](https://docs.hologram.io/guides/get-started/set-the-device-apn.md): Hologram SIMs are hardware-agnostic, and should work with any hardware that is not locked to a carrier. To use a Hologram SIM, set your device's APN to `hologram`. The APN allows your device to properly set up a connection to the gateway between Hologram and the Internet. - [Network selection](https://docs.hologram.io/guides/get-started/network-selection.md) - [Data metering](https://docs.hologram.io/guides/get-started/data-metering.md): Usage information posted on the Dashboard comes directly from our carrier partners, all of whom are members of the GSM Association. They all use standard protocols and interfaces, and provide us with the information as reported from the gateway. This guide reviews how data metering at Hologram works… - [Device certifications](https://docs.hologram.io/guides/get-started/device-certifications.md): The device certification process ensures compliance with cellular network standards. Hologram requires your devices have at least a PTCRB or GCF certification. - [The ultimate guide to the Internet of Things](https://docs.hologram.io/guides/get-started/ultimate-guide-to-iot.md): A comprehensive introduction to IoT technology, applications, and best practices - [The ultimate guide to IoT security](https://docs.hologram.io/guides/get-started/the-ultimate-guide-to-iot-security.md): This article will provide an overview to all things IoT security and provide a jumping off point for further discovery. For any and all security-related questions, reach out to the Hologram support team! - [Security at Hologram](https://docs.hologram.io/guides/troubleshooting/security-at-hologram.md): Overview of Hologram's network and platform security, including monitoring and isolation. - [Glossary of Hologram temininology](https://docs.hologram.io/guides/get-started/glossary.md): Plain-language definitions of the terms you'll see across Hologram, including organizations, active SIMs, pre-deployment, monthly recurring charge (MRC), billing types, and the difference between a paused and a suspended SIM. - [Contact support](https://docs.hologram.io/guides/get-started/contact-support.md): Get in touch with our support team for detailed troubleshooting or specific requests. - [All about Hologram SIMs](https://docs.hologram.io/guides/sims/overview.md) - [Where can I purchase Hologram SIMs?](https://docs.hologram.io/guides/sims/purchase-hologram-sims.md): You can purchase Hologram Hyper SIM cards directly from [our store](https://store.hologram.io/store/) in quantities of 1 to 1,000. - [Hologram SIM formats](https://docs.hologram.io/guides/sims/hologram-sim-formats.md): Hologram Hyper SIMs and Global eUICC IoT SIMs are available in multiple form factors to suit a wide range of deployments. Hyper SIMs are available in industrial gradetriple cut 2FF/3FF/4FF and embedded DFN8 MFF2 form factors. - [Hologram IoT SIM datasheets](https://docs.hologram.io/guides/sims/hologram-iot-sim-datasheets.md): Hologram provides global IoT SIMs for every use case. Hardware and software specifications for Hologram IoT Hyper SIMs along with downloadable PDFs are available in this guide. SIMs are available in triple cut card, embedded MFF2, and eSIM form factors across SGP.02, SGP.22, and SGP.32 specification… - [How does Hologram use eUICC?](https://docs.hologram.io/guides/sims/how-does-hologram-use-euicc.md): Hologram's Hyper SIMs use eUICC to enable global connectivity coverage and perform over-the-air updates to your devices. eUICC on a SIM acts as a sort of digital wallet that lets you use several different “credit cards” (or subscription profiles), all on the same eUICC SIM card. One eUICC SIM can sw… - [How do I organize my devices and SIMs?](https://docs.hologram.io/guides/sims/how-to-organize-your-fleet.md): Keep your fleet organized with tags and consistent naming conventions. - [View and organize SIMs in your dashboard](https://docs.hologram.io/guides/sims/organize-sims.md): Navigate and manage your fleet of SIMs across Active, Pre-deployment, and Deactivated pages - [Device location and location history](https://docs.hologram.io/guides/sims/location-and-history.md): View approximate tower location information and location history for your Hologram SIMs - [What is a Hyper SIM with Outage Protection?](https://docs.hologram.io/guides/sims/what-is-a-hyper-sim-with-outage-protection.md): Overview of Hologram Hyper SIMs with Outage Protection, network fallback, benefits, and FAQs. - [What is Outage Protection?](https://docs.hologram.io/guides/sims/outage-protection.md): Hologram's multi-core SIMs with Outage Protection can switch mobile cores automatically in the case an installed profile loses connectivity, protecting you from downtime and outages. When a SIM switches connectivity profiles automatically, we call this a **Outage Protection**. - [What are fallback events for Hyper SIMs with Outage Protection?](https://docs.hologram.io/guides/sims/fallback-events.md): Hologram's Hyper SIMs with Outage Protection can switch mobile cores automatically in the case an installed profile loses connectivity, protecting you from downtime and outages. When a SIM switches connectivity profiles automatically, we call this a **fallback event**. - [Can I manually switch profiles on a Multi-Core SIM?](https://docs.hologram.io/guides/sims/can-i-manually-switch-profiles.md): Hologram's Multi-Core Hyper SIMs provide multiple mobile cores, each with their own network coverage. If these SIMs lose connectivity, they switch mobile cores automatically and change to backup network coverage, using our network fallback technology to automate this change. - [Pre-deployment testing with Test Mode](https://docs.hologram.io/guides/sims/test-mode.md): **Hologram Test Mode** is a set of tools and capabilities to streamline the cellular IoT supply chain for your organization. Test your devices with free data, deploy to your customers seamlessly, and minimize costs. - [Country and network coverage](https://docs.hologram.io/guides/get-started/country-and-network-coverage.md): Hologram provides global coverage across 550+ networks in 190+ countries to connect your devices anywhere your fleets are deployed. You can find detailed coverage information on our [coverage page](https://www.hologram.io/coverage/). - [Network selection](https://docs.hologram.io/guides/get-started/network-selection.md) - [Cat-M1 (LTE-M) and NB-IoT coverage](https://docs.hologram.io/guides/get-started/catm1-and-nbiot-coverage.md): Cat-M (LTE-M) and NB-IoT are low-power cellular technologies designed specifically for IoT devices with reduced bandwidth needs and extended battery life. - [Does Hologram provide coverage in the UAE?](https://docs.hologram.io/guides/troubleshooting/uae-coverage.md): Yes. Hologram global SIMs can connect in the United Arab Emirates; permanent deployments require UAE IoT certification. - [Conductor for SIM orchestration at scale](https://docs.hologram.io/guides/sims/conductor.md): **Conductor** is Hologram's SIM orchestration tool for engineering and operations teams managing IoT deployments in production. As fleets grow and carriers multiply, the work of managing SIM profiles, switching networks, and recovering connectivity becomes its own engineering problem. Conductor hand… - [What are typical data transmission speeds?](https://docs.hologram.io/guides/sims/what-are-typical-data-transmission-speeds.md): Expected cellular speeds for IoT devices and considerations for Cat-M1 and NB-IoT. - [Profile performance in the U.S.](https://docs.hologram.io/guides/sims/profile-performance-in-the-us.md): Evaluate how latency and throughput performance informs which profile is best suited for your use case. - [Hologram SIM ordering and shipping FAQs](https://docs.hologram.io/guides/sims/hologram-sim-ordering-and-shipping-faqs.md): Get answers to some of the most frequently asked ordering and shipping questions about the [Hologram Store](https://hologram.io/store/). - [Return and refund policy](https://docs.hologram.io/guides/sims/return-and-refund-policy.md): At Hologram, our goal is to make sure that you are happy with our products and services. If you have any issues with the SIMs you have received, please email us at [support@hologram.io](mailto:support@hologram.io). - [What communication protocols are compatible with Hologram SIMs?](https://docs.hologram.io/guides/sims/what-communication-protocols-are-compatible-with-hologram-sims.md): Overview of methods for sending data to and from devices using Hologram SIMs, including Hologram Cloud messaging, direct IP, Spacebridge tunneling, and SMS. - [Send SMS to devices using the REST API](https://docs.hologram.io/guides/cloud-and-tools/send-sms-to-devices-using-the-rest-api.md): Examples for sending SMS to devices using curl and Python requests. - [Purchase a phone number to send SMS messages to a SIM](https://docs.hologram.io/guides/communication/purchase-a-phone-number-to-send-sms-messages-to-a-sim.md): All Hologram SIMs include a non-geographic phone number for inbound SMS from anywhere in the world. You can also purchase a localized country-specific number for inbound SMS if your use case requires it. - [Send a circuit-switched SMS message to the Hologram Cloud](https://docs.hologram.io/guides/cloud-and-tools/send-a-circuit-switched-sms-message-to-the-hologram-cloud.md): How to send circuit-switched SMS to the Cloud and view messages. - [Send and receive SMS via mmcli](https://docs.hologram.io/guides/communication/send-and-receive-sms-via-mmcli.md): Learn how to test end-to-end SMS on a Linux device with a Hologram SIM using ModemManager (`mmcli`) on a Linux device such as a Raspberry Pi. Send a message to your device, confirm the device received it, send a reply, and verify delivery. - [Troubleshooting undelivered SMS messages](https://docs.hologram.io/guides/troubleshooting/troubleshooting-undelivered-sms-messages.md): Diagnose SMS delivery issues for messages sent to or from a Hologram device. - [Purchase a phone number to send SMS messages to a SIM](https://docs.hologram.io/guides/communication/purchase-a-phone-number-to-send-sms-messages-to-a-sim.md): All Hologram SIMs include a non-geographic phone number for inbound SMS from anywhere in the world. You can also purchase a localized country-specific number for inbound SMS if your use case requires it. - [Does the Hologram SIM support voice calling?](https://docs.hologram.io/guides/communication/does-the-hologram-sim-support-voice-calling.md): Hologram IoT SIMs support VoIP communications using data. - [What is Hologram cloud messaging?](https://docs.hologram.io/guides/cloud-and-tools/what-is-hologram-cloud-messaging.md): Hologram cloud messaging forwards data between your device and the internet using the device's cellular data connection. It supports both outbound (device to cloud) and inbound (cloud to device) messaging. - [Device tunneling for beginners](https://docs.hologram.io/guides/communication/device-tunneling-for-beginners.md): Create an inbound Spacebridge tunnel to a device using a Hologram SIM. - [Establish a secure Spacebridge tunnel to a device using SSH](https://docs.hologram.io/guides/communication/establish-a-secure-spacebridge-tunnel-to-a-device-using-ssh.md): Enable tunneling, upload an SSH key, and open a Spacebridge tunnel using port forwarding. - [View device tunneling keys using the REST API](https://docs.hologram.io/guides/communication/view-device-tunneling-keys-using-the-rest-api.md): Retrieve Spacebridge tunneling keys via the REST API. - [Add device tunneling keys using the REST API](https://docs.hologram.io/guides/communication/add-device-tunneling-keys-using-the-rest-api.md): Create Spacebridge tunneling keys via the REST API. - [Enable and disable device tunneling keys using the REST API](https://docs.hologram.io/guides/communication/enable-and-disable-device-tunneling-keys-using-the-rest-api.md): Manage Spacebridge tunneling keys with enable/disable API calls. - [Troubleshooting device tunneling](https://docs.hologram.io/guides/communication/troubleshooting-device-tunneling.md): Resolve common Spacebridge tunneling issues and key limitations. - [What is event monitoring, and how do alerts work?](https://docs.hologram.io/guides/cloud-and-tools/event-monitoring-and-alerts-overview.md): Alerts provide a way to send email or webhook notifications when specific events occur in your fleet, such as when a data limit is reached or an IMEI TAC change is detected for a device. - [Use variables from events in alerts](https://docs.hologram.io/guides/cloud-and-tools/use-event-variables-in-alerts.md): Use variables to reference event data and insert into Alert email and webhook notifications sent to your team or systems. - [Event monitoring and alerting types and tags](https://docs.hologram.io/guides/cloud-and-tools/event-types-and-tags.md): This guide outlines available event types and event tags for event monitoring and alerting. Event tags are used to identify the type of event that occurred, the SIM affected by the event, and any SIM tags that were attached to SIMs affected by the event. You can subscribe to events and receive notif… - [Troubleshooting alert and webhook errors](https://docs.hologram.io/guides/troubleshooting/troubleshooting-alerts-and-webhooks.md): This guide reviews troubleshooting steps for some common issues when using alerts and webhooks. You can use webhooks to communicate with applications and services through Hologram SIMs. Using alerts, you can subscribe to events and receive webhook notifications when specific events occur in your fle… - [How billing works at Hologram](https://docs.hologram.io/guides/billing/how-billing-works.md): Learn how billing works at Hologram. - [Set up your account for billing](https://docs.hologram.io/guides/billing/configure-billing-account.md): Learn how to set up your account for billing, add a billing address, add a payment method, and enable auto-refill. - [What data plans does Hologram offer, and how do they work?](https://docs.hologram.io/guides/billing/data-plans-overview.md): Data plans determine how your SIMs are charged for data usage. Understanding different plan types helps you choose the right plan for your needs. - [How can I manage and limit my fleet's data usage?](https://docs.hologram.io/guides/billing/manage-fleet-data-usage.md): Strategies for controlling and optimizing data consumption across your IoT deployment - [What data plan should I choose?](https://docs.hologram.io/guides/billing/what-data-plan-should-i-choose.md): Selecting the best data plan for your fleet(s) will vary based on your unique use case, deployment locations, and hardware. - [How does network-level billing work?](https://docs.hologram.io/guides/billing/network-level-billing-overview.md): **Network-level billing** (NLB) is a pay-as-you-go billing method where you're charged per megabyte based on the specific cellular network your SIM connects to. Instead of paying a single flat rate for all data usage, your rate varies depending on which carrier network handles your device's connecti… - [How do I automatically refill my account balance?](https://docs.hologram.io/guides/billing/auto-refill.md): Most Hologram organizations are prepaid and have an account balance that they will draw down from like a debit card or checking account. **Auto-refill** automatically adds funds to your account when your balance falls below a specified threshold, helping prevent service interruptions for your IoT de… - [What happens if I don't have enough money in my account?](https://docs.hologram.io/guides/billing/insufficient-balance.md) - [Transfer balance to another organization](https://docs.hologram.io/guides/billing/transfer-balance.md): Transfer any part of an organization's available balance to another organization by contacting support. - [Invoiced billing overview](https://docs.hologram.io/guides/billing/invoiced/postpaid-billing-overview.md): Invoiced billing works like a credit card. Your organization accrues charges throughout a calendar month, then receives an invoice at the end of the month for all monthly recurring charges and data usage. - [What happens when my organization's billing method changes?](https://docs.hologram.io/guides/billing/what-happens-when-billing-methods-change.md): If your organization is switching billing methods, for example from prepaid billing to invoiced billing, several aspects of how you pay for and view your Hologram services will change. This guide explains what to expect during and after the transition. - [Where can I find and pay invoices?](https://docs.hologram.io/guides/billing/invoiced/invoices.md): How to view and receive invoices for organizations with monthly invoicing - [How to interpret billing transactions](https://docs.hologram.io/guides/billing/statements-and-transactions.md) - [Breakdown of billing and SIM charges](https://docs.hologram.io/guides/billing/breakdown-of-billing-and-sim-charges.md): Learn about the three types of charges for Hologram SIMs: monthly recurring charges, data usage rates, and outbound SMS costs — including why an active SIM is charged even when it isn't using data. - [What does it mean to have custom billing?](https://docs.hologram.io/guides/billing/custom/custom-billing-overview.md): Custom billing solutions are used for some contracted organizations with unique billing requirements that don't fit standard prepaid or invoiced models. These solutions accommodate complex data plan structures, specialized pricing, and other unique billing requirements. - [Beginner's guide to the Hologram REST API](https://docs.hologram.io/guides/rest-api/beginners-guide-to-the-hologram-rest-api.md): Learn about core concepts, authentication, and common endpoints to manage SIMs and devices via the REST API. Use the REST API to automate actions you perform in your dashboard, such as SIM activation, tagging, plan changes, messaging, and monitoring. - [Generate and manage your REST API key](https://docs.hologram.io/dashboard/account/rest-api-key.md): Your API key is your personal access token for the Hologram REST API, and can be managed in the **Settings** page in the main menu, under the **My account** tab. Your API key gives you access to your personal account, as well as any organizations you are a member of. - [Activate multiple SIMs in bulk using the REST API](https://docs.hologram.io/guides/rest-api/activate-sims-in-bulk-using-the-rest-api.md): Activating SIMs via the [Dashboard](/dashboard/activation/activation-overview) is a great option if you are only doing so for a handful of devices, but what if you want to activate dozens, hundreds, or even thousands of devices? For this we recommend using our [REST API](/api/1/). This option lets y… - [Change SIM data plans in bulk using the REST API](https://docs.hologram.io/guides/rest-api/change-sim-data-plans-in-bulk-using-the-rest-api.md): Collect link IDs and plan details, then change plans for many SIMs via the REST API. - [Deactivate SIMs using the REST API](https://docs.hologram.io/guides/rest-api/deactivate-sims-using-the-rest-api.md): Deactivate SIMs in bulk using the REST API, and understand the implications of permanent SIM deactivation. - [Determine device's location via the REST API](https://docs.hologram.io/guides/rest-api/determine-devices-location-via-the-rest-api.md): Retrieve approximate device location from the last session via the Devices endpoint. - [Determine if SIM is standard or industrial-grade using the REST API](https://docs.hologram.io/guides/rest-api/determine-if-sim-is-standard-or-industrial-grade-using-the-rest-api.md): All new Hologram SIMs are industrial grade. Check legacy SIM grade via the links/cellular endpoint and the sim_attribute field. - [Get data usage by IMEI through the REST API](https://docs.hologram.io/guides/rest-api/get-data-usage-by-imei-through-the-rest-api-python.md): Look up a device by IMEI, then fetch usage via REST API with a Python example. - [Rename SIMs using the REST API](https://docs.hologram.io/guides/rest-api/rename-sims-using-the-rest-api.md): Rename devices individually or in bulk via the REST API. - [Send and receive SMS using the REST API](https://docs.hologram.io/guides/rest-api/send-and-receive-sms-using-the-rest-api.md): You can use the Hologram REST API to send and receive SMS messages on your device. Use the SMS incoming endpoint to send a message to a device and read SMS responses via Data Engine logs. - [Set a SIM's SMS limit using the REST API](https://docs.hologram.io/guides/rest-api/set-a-sims-sms-limit-using-the-rest-api.md): Configure outbound SMS limits per SIM and understand pause behavior. - [Tag SIMs using the REST API](https://docs.hologram.io/guides/rest-api/tag-multiple-sims-using-the-rest-api.md): If you want to tag hundreds, or even thousands of devices, we recommend using our REST API for additional control over how your SIMs are named. - [Migrate from 1NCE to Hologram](https://docs.hologram.io/guides/migrations/1nce-to-hologram.md): This guide helps you migrate from 1NCE's Management API to Hologram's REST API. It covers authentication, endpoint paths, parameter names, identifier schemes, status values, and features that differ between the two platforms. - [How can I check the status of Hologram's systems?](https://docs.hologram.io/guides/troubleshooting/how-to-check-hologram-system-status.md) - [Hologram's scope of support](https://docs.hologram.io/guides/troubleshooting/holograms-scope-of-support.md): What Hologram support covers vs. what is out of scope (professional services). - [Hologram Support priority levels](https://docs.hologram.io/guides/troubleshooting/hologram-support-priority-levels.md): Understand P1, P2, and P3 support priorities and how to choose the right level. - [How to find SIM ICCIDs and EIDs](https://docs.hologram.io/guides/troubleshooting/how-to-find-sim-iccids-and-eids.md): Where to find ICCIDs and EIDs on SIM cards, packaging, and in the Dashboard. - [IMEISV vs IMEI](https://docs.hologram.io/guides/troubleshooting/imeisv-vs-imei.md): Understand the difference between IMEI and IMEISV and how they appear in Hologram. - [Why does my modem show my ICCID with an extra F at the end?](https://docs.hologram.io/guides/troubleshooting/why-iccid-has-extra-f.md): Some modems pad ICCIDs with an 'F' character; remove it before using the ICCID in Hologram systems. - [What is my organization ID (orgid)?](https://docs.hologram.io/guides/troubleshooting/find-org-id.md): Locate your organization's unique numerical identifier in the dashboard - [Why is my device not showing an IMEI?](https://docs.hologram.io/guides/troubleshooting/why-is-my-device-not-showing-an-imei.md): IMEI may not always be available for a SIM. This can be expected in some cases. - [Troubleshooting connecting to the Hologram network](https://docs.hologram.io/guides/troubleshooting/troubleshooting-connecting-to-the-hologram-network.md): This guide reviews steps to follow if you are having trouble connecting to the Hologram network. Systematically isolate connectivity issues across device, SIM, network, and application layers. - [Connect a Raspberry Pi to the internet using a Hologram SIM](https://docs.hologram.io/guides/troubleshooting/connect-a-raspberry-pi-to-the-internet-via-cellular-modem.md): Connect a Raspberry Pi to the internet using a cellular modem and a Hologram SIM with NetworkManager (nmcli) and ModemManager (mmcli), then verify connectivity with a ping test. - [Modem & SIM annotated diagnostic test](https://docs.hologram.io/guides/troubleshooting/modem-and-sim-annotated-diagnostic-test.md): Run a standard set of AT commands to capture modem, SIM, registration, and APN state for troubleshooting. - [AT command reference and troubleshooting cellular modules](https://docs.hologram.io/guides/troubleshooting/at-command-reference-and-troubleshooting-cellular-modules.md): Common AT commands to configure, monitor, and troubleshoot cellular modules with examples and next steps. - [Introduction to AT commands](https://docs.hologram.io/guides/troubleshooting/introduction-to-at-commands.md): Learn AT command basics and operators (read, set, test) for modem control. - [Automated modem diagnostics using Python](https://docs.hologram.io/guides/troubleshooting/automated-modem-diagnostics-using-python.md): Run automated modem diagnostics and save results to a file. - [Clear the FPLMN (forbidden networks) list](https://docs.hologram.io/guides/troubleshooting/clear-the-fplmn-forbidden-networks-list.md): Understand when and how to clear the SIM's Forbidden PLMN list using AT commands. - [Device using odd or unexpected amounts of data](https://docs.hologram.io/guides/troubleshooting/unexpected-data-usage.md): Common causes and debugging steps for unexpected data consumption - [Find and troubleshoot zero-byte sessions](https://docs.hologram.io/guides/troubleshooting/find-and-troubleshoot-zero-byte-sessions.md): Identify zero-byte sessions and resolve common causes such as APN misconfiguration or firmware behavior. - [Troubleshooting undelivered SMS messages](https://docs.hologram.io/guides/troubleshooting/troubleshooting-undelivered-sms-messages.md): Diagnose SMS delivery issues for messages sent to or from a Hologram device. - [Troubleshooting alert and webhook errors](https://docs.hologram.io/guides/troubleshooting/troubleshooting-alerts-and-webhooks.md): This guide reviews troubleshooting steps for some common issues when using alerts and webhooks. You can use webhooks to communicate with applications and services through Hologram SIMs. Using alerts, you can subscribe to events and receive webhook notifications when specific events occur in your fle… - [How do I reset my password?](https://docs.hologram.io/guides/troubleshooting/how-do-i-reset-my-password.md): Reset your Hologram Dashboard password and troubleshoot common issues with reset emails. - [What can I do if I haven't received a verification email?](https://docs.hologram.io/guides/troubleshooting/what-can-i-do-if-i-havent-received-a-verification-email.md): Steps to find or receive your Hologram account verification email. - [No permissions to perform operation error](https://docs.hologram.io/guides/troubleshooting/no-permissions-to-perform-operation-error.md): Resolve permission errors by updating your collaborator role in the organization. - [Unable to transfer SIM to new organization](https://docs.hologram.io/guides/troubleshooting/unable-to-transfer-sim-to-new-organization.md): Resolve transfer issues caused by data plan mismatches or missing permissions. - [What causes the "Paused by system" SIM status?](https://docs.hologram.io/guides/troubleshooting/paused-by-system-sim-status.md): Why a SIM is paused by system and how to resolve it (balance, data limit, SMS limit). - [Dashboard documentation](https://docs.hologram.io/dashboard/get-started.md): Hologram's dashboard is a simple, comprehensive tool to manage global device fleets of any size. Your dashboard provides everything you need to quickly troubleshoot, diagnose, and act on connectivity issues across your fleet.

Here you'll find detailed documentation about features, function… - [Create a new Hologram account](https://docs.hologram.io/dashboard/create-an-account.md): Create a new Hologram account and learn how to manage your globally connected SIMs, understand data usage, collaborate with your team, and receive billing information. - [Log in to your account](https://docs.hologram.io/dashboard/log-in-to-dashboard.md): This guide will walk you through how to log in to your dashboard, create an account, or reset your password. The first step will be looking for the **Log in** button on the upper right hand corner of our [website](https://www.hologram.io/). - [Home page](https://docs.hologram.io/dashboard/home-page.md): The Home page gives you a quick heads-up view of the all the SIMs in your organization. Teams large and small can get real-time visibility and a quick pulse check on their fleet's health, connectivity statuses, inventory counts, and Test Mode readiness. - [Activate SIMs](https://docs.hologram.io/dashboard/activation/activation-overview.md): Activating SIM cards is easy with Hologram. Whether you are activating one SIM or thousands, you can bulk activate and get connected quickly. - [SIMs pages](https://docs.hologram.io/dashboard/sims/sims-overview.md): Organize, manage, and take actions on all the SIMs in your fleet from the SIMs pages. - [SIM states and statuses](https://docs.hologram.io/dashboard/sims/sim-states-and-statuses.md): Hologram SIMs in the dashboard and REST API can be in many different statuses or states based on how they are configured and whether they are able to transmit data. Learn what Ready, Connected, Paused by user, and Paused by system mean and how to move between them. - [Search for SIMs and devices](https://docs.hologram.io/dashboard/sims/search.md): Use the global search to quickly find any SIM or device in your organization by ICCID, name, IMEI, SIM ID, device ID, so that you can dig deeper or take quick actions. - [Active SIMs page](https://docs.hologram.io/dashboard/sims/sims-active.md): The default view of your SIMs shows all Hologram SIMs that are able to connect to the internet, including all Paused and Ready SIMs. These SIMs have been activated are charged a per-SIM monthly recurring charge for access to our platform and network. - [Pre-deployment SIMs page](https://docs.hologram.io/dashboard/sims/sims-predeployment.md): The Pre-deployment SIMs page lists all SIMs that have not yet been activated, and are not being charged monthly recurring charges. This is the main page used to manage SIMs configured for pre-deployment testing using Test Mode. - [Deactivated SIMs page](https://docs.hologram.io/dashboard/sims/sims-deactivated.md): Deactivated SIMs are **permanently disabled**, removed from Hologram's network, and are not able to be reactivated. SIMs are most often deactivated when they are no longer needed, a device is lost, destroyed, stolen, or on accident. You may still need to refer to past data usage or configuration inf… - [Filtering the SIMs pages](https://docs.hologram.io/dashboard/sims/sims-filters.md): 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. - [Export SIMs data](https://docs.hologram.io/dashboard/sims/sims-export.md): Hologram makes it simple to export your data. While your dashboard is helpful for looking into the behavior of your SIMs, most reporting on SIM and usage data happens by combining data in Excel or your own systems. - [View user pause, resume, and activation history](https://docs.hologram.io/dashboard/sims/sims-activity-history.md): The **Activity history** page allows you to find the history of all completed user-initiated activation, pause, and resume actions taken in the Hologram dashboard or REST API. - [SIM details page](https://docs.hologram.io/dashboard/sims/sim-details-overview.md): Navigating to a SIM from search or the SIMs pages opens the **SIM details** page. Here you can find key identifiers, recent behavior, connectivity details, and all the actions you can take on that SIM. This page is also the first place to look when troubleshooting a SIM. - [Where to find SIM, device, and profile IDs](https://docs.hologram.io/dashboard/sims/sim-identifiers.md): Learn about the primary identifiers for SIMs, devices, and profiles, and where to find them in your dashboard. - [SIM Status tab](https://docs.hologram.io/dashboard/sims/sim-details-status-tab.md): This view of a single SIM provides an overview of the SIM's current connectivity, status, last known session details, last known location, and data usage for the SIM's current billing period. - [SIM and device details tab](https://docs.hologram.io/dashboard/sims/sim-details-sim-and-device-tab.md): The **SIM and device** for a single SIM provides detailed information about settings, IDs, and configuration information for a Hologram SIM, and any information we have about the device we last saw it in as provided by session records. Information provided in this tab is similar to device details re… - [SIM Profiles tab](https://docs.hologram.io/dashboard/sims/sim-details-profiles-tab.md): Find detailed information about connectivity profiles installed on a SIM. For multi-core Hyper SIMs, the Profiles tab details how Outage Protection will work for multi-core Hyper SIMs and provides details about past fallback events and profile installation history. - [SIM Recent sessions tab](https://docs.hologram.io/dashboard/sims/sim-details-recent-sessions-tab.md): This view of a SIM provides near-real-time view of recent, closed data sessions within the last 90 days. - [SIM Recent data usage tab](https://docs.hologram.io/dashboard/sims/sim-details-data-usage-recent-tab.md): Detailed session-level data usage for a SIM is found in the **Data usage tab**. These reports display recent data usage for the SIM's current billing period, broken down by network, profile, day, and location, with limited historical session reporting. - [SIM data usage tab](https://docs.hologram.io/dashboard/sims/sim-details-data-usage-tab.md): Detailed, historical session-level data usage for a SIM is found in the **Data usage tab** for qualifying organizaitons. These reports display historical data usage for the SIM's current billing period, broken down by network, profile, day, and location, with limited historical session reporting. - [Explore SIM coverage and rates](https://docs.hologram.io/dashboard/sims/sim-details-coverage-tab.md): Use Coverage Explorer in a SIM's **Coverage** tab to find the exact networks your SIM can connect to and the rates you can expect to pay per MB. A SIM's available coverage is determined by the SIM's active data plan, and the profiles installed on the SIM card. The enabled profile on a SIM determines… - [SIM pricing and data plan details](https://docs.hologram.io/dashboard/sims/sim-details-pricing-tab.md): Find a summary of data plan pricing and rates for a SIM in the Pricing tab. This tab also lists monthly recurring charges, data limits, billing period details, and any add-ons associated with the SIM, like phone numbers. - [SIM Events tab](https://docs.hologram.io/dashboard/sims/sim-details-events-tab.md): Event history is a record of Hologram Cloud events tracked for a SIM, including messaging, IMEI changes, data limits reached, and more. Events are created when specific events occur in your fleet, and are tracked using event tags. Get notified when events occur by creating an [alert](/dashboard/even… - [SIM Alerts tab](https://docs.hologram.io/dashboard/sims/sim-details-alerts-tab.md): Use the Alerts tab to create and manage alerts for Hologram Cloud events tracked for a SIM. Events that trigger alerts display on the Events tab, and include SIM messaging, IMEI changes, data limits reached, and more. - [Manage a single SIM](https://docs.hologram.io/dashboard/sim-actions/single-sim-actions-overview.md): Your dashboard gives you the ability to take direct actions on your SIMs while referencing the most important information you need for troubleshooting. Take actions on a single SIM from its details page with full control over SIM management. - [Take bulk actions on your SIMs](https://docs.hologram.io/dashboard/sim-actions/bulk-actions-overview.md): Your dashboard gives you control to manage, troubleshoot, and act on your devices in a simple interface. This guide covers the bulk actions available for managing multiple SIMs at once through the Hologram Dashboard, providing efficient ways to perform common operations across your fleet. - [Change data plans](https://docs.hologram.io/dashboard/sim-actions/change-data-plans.md): Move SIMs to a different data plan to adjust network coverage or pricing. If you have contracted rates, you may want to change data plans to make sure your SIMs are on the right plan for your needs. - [End Test Mode and activate SIMs](https://docs.hologram.io/dashboard/sim-actions/force-activate-from-test-mode.md): Activate multiple SIMs out of pre-deployment testing before their free testing period has completed. This action activates SIMs out of Test Mode, and begins regular billing of data usage and monthly recurring charges. - [Pause or resume SIMs' data usage](https://docs.hologram.io/dashboard/sim-actions/pause-resume-sims.md): You can pause or resume data usage for multiple SIMs in bulk through your dashboard. This action prevents or allows data usage across your selected SIMs without affecting their activation status. - [Rename SIMs](https://docs.hologram.io/dashboard/sim-actions/rename-sims.md): Rename multiple SIMs at once using custom prefixes to improve organization and identification across your fleet. This action helps maintain consistent naming conventions and makes device management more efficient. - [Enable or disable secure device tunneling with Spacebridge](https://docs.hologram.io/dashboard/sim-actions/spacebridge-tunneling.md): Configure Spacebridge tunneling to enable or disable secure, authenticated tunnels for inbound connectivity to any port on your IoT devices. Spacebridge provides secure remote access without exposing devices to the public internet. - [Send messages to SIMs](https://docs.hologram.io/dashboard/sim-actions/send-messages-to-sims.md): Learn how to send SMS, TCP, or UDP messages to SIMs through the Hologram Dashboard. This feature enables you to communicate with your devices or trigger specific actions across your fleet. - [Set data usage limits](https://docs.hologram.io/dashboard/sim-actions/set-usage-limits.md): Data usage limits help you manage your SIMs' data usage and prevent unexpected charges or overage. - [Monitor usage with data usage warning thresholds](https://docs.hologram.io/dashboard/sim-actions/set-data-warning-threshold.md): Data warnings help you monitor data usage and take action before incurring additional charges or reaching a data usage limit. Set a data warning threshold to create an [event](/guides/cloud-and-tools/event-types-and-tags) when a certain amount of data is reached. Then, create an [alert](/dashboard/e… - [Switch profiles on a Multi-Core SIM](https://docs.hologram.io/dashboard/sim-actions/switch-profiles.md): You can manually switch profiles on Multi-Core Hyper SIMs with Outage Protection to optimize connectivity. - [Tag SIMs](https://docs.hologram.io/dashboard/sim-actions/tag-sims.md): Organize and manage your SIM fleet with tags. Tags help you categorize and report on SIMs by deployment location, device type, fleet customer, or any other criteria you choose. - [Transfer SIMs to a different organization](https://docs.hologram.io/dashboard/sim-actions/transfer-to-organization.md): Transfer SIMs between organizations to organize your team's device deployments and consolidate organizations. Since SIMs belong to organizations and not users, transferring a SIM effectively transfers its ownership. - [Deactivate SIMs](https://docs.hologram.io/dashboard/sim-actions/deactivate-sims.md): Deactivation is a **permanent, irreversible process** that ends all network connectivity and billing for a SIM that you no longer need. - [View and track fleet data usage](https://docs.hologram.io/dashboard/usage/usage-overview.md): We provide a wide range of data usage reports to help analyze and manage data usage across your fleet and optimize your IoT operations. This suite of reporting is built to answer the common questions encountered during configuration, deployment, field testing, and troubleshooting. - [Active SIMs data usage reports](https://docs.hologram.io/dashboard/usage/usage-active-sims.md): Reporting to help you analyze and manage data usage across your fleet of active SIMs. Historical data usage reporting is provided by day, SIM, location, and session. - [Active SIMs recent data usage reports](https://docs.hologram.io/dashboard/usage/usage-active-sims-recent.md): Reporting to help you analyze and manage data usage across your fleet of active SIMs. Recent data usage reporting is available by day, SIM, and location. - [Pre-deployment SIMs data usage reports](https://docs.hologram.io/dashboard/usage/usage-predeployment-sims.md): Reporting to help you analyze and manage data usage across your fleet of pre-deployment SIMs in Test Mode. Hologram's pre-deployment reporting helps customers with Test Mode understand the state of their full inventory of Test Mode SIMs, activation behavior, and historical analysis of Test Mode acti… - [Single SIM data usage reports](https://docs.hologram.io/dashboard/usage/usage-single-sim.md): Data usage reporting at the SIM level across networks, locations, profiles, and sessions to help troubleshoot specific SIM data usage behavior and device-level issues. - [Billing section overview](https://docs.hologram.io/dashboard/billing/billing-overview.md): The **Billing** section of your dashboard provides an overview of your billing account balance, allows you to manage your billing settings and payment method, and provides access to your billing statements and transactions. - [Account overview page](https://docs.hologram.io/dashboard/billing/billing-account-overview.md): Your billing account page provides an overview of your billing account balance, billing address, and payment method. This is where you can add a billing address and credit card so that you can activate SIMs for the first time. - [Auto-refill your account balance](https://docs.hologram.io/dashboard/billing/auto-refill.md): Most Hologram organizations are prepaid and have an account balance that they will draw down from like a debit card or checking account. **Auto-refill** automatically adds funds to your account when your balance falls below a specified threshold, helping prevent service interruptions for your IoT de… - [Add account balance](https://docs.hologram.io/dashboard/billing/add-balance.md): Top up your prepaid balance to keep your SIMs connected - [Add a promo code](https://docs.hologram.io/dashboard/billing/promo-codes.md): Apply promotional codes to add credits to your account balance - [Add or change a billing address](https://docs.hologram.io/dashboard/billing/update-billing-address.md): A billing addresses is required for all organizations to activate SIMs, make purchases, and refill account balances. - [Add or change a credit card for payment](https://docs.hologram.io/dashboard/billing/update-payment-method.md): All organizations must have a credit card on file in order to activate SIMs, make purchases, and refill account balances. - [Data plans pages](https://docs.hologram.io/dashboard/billing/data-plans.md): The **Data plans** page provides a list of all data plans available to your organization. Clicking into a data plan provides detailed pricing, rate, and coverage information for SIMs active on that data plan. - [Coverage Explorer](https://docs.hologram.io/dashboard/billing/coverage-explorer.md): Use Coverage Explorer to find network coverage and rates available on a data plan. Find specific details with search and filters by profile, RAT, and country. - [Billing transactions and balance history](https://docs.hologram.io/dashboard/billing/statements-and-transactions.md): Billing transactions provide a historical view of all billed charges for your organization. If you have questions about charges, invoice details, or want to analyze the underlying data, start with billing transactions. - [Receipts page](https://docs.hologram.io/dashboard/billing/credit-card-receipts.md): All charges made with a credit card are recorded in the **Receipts** page. Most organizations can find credit card receipts within the Receipts page in the main menu. Organizations with monthly invoicing can find receipts in the [Invoices](/dashboard/billing/invoices) page. - [Invoices page](https://docs.hologram.io/dashboard/billing/invoices.md): Organizations with monthly invoicing can find and pay invoices in the **Invoices** page. Credit card receipts can be found in the **Credit card receipts** tab. - [Review, add, and remove email addresses that receive credit card receipts and invoices](https://docs.hologram.io/dashboard/billing/billing-email-recipients.md): Manage who receives billing notification emails for your organization. - [View event history](https://docs.hologram.io/dashboard/event-monitoring/event-history.md): View a history of events created in the Hologram Cloud across your fleet, including SIM messaging, IMEI changes, data limits reached, and more. Events are created when specific events occur in your fleet, and are tracked using event tags. Get notified when events occur by creating an [alert](/dashbo… - [Set up notifications for events using Alerts](https://docs.hologram.io/dashboard/event-monitoring/alerts-and-notifications.md): When events occur in your fleet, events are created in the Hologram Cloud that you can view in the **Event monitoring** section of your dashboard. You can create **Alerts** to subscribe to these events when they occur and send notifications via email or webhooks. - [Detect IMEI events and get notified when a SIM has moved to another device](https://docs.hologram.io/dashboard/event-monitoring/tac-change-detection.md): Track when SIMs are moved between devices using IMEI and TAC change detection. IMEI and IMEI TAC change events are available in [Event monitoring](/guides/cloud-and-tools/event-monitoring-and-alerts-overview) and can be used to create [alerts](/guides/cloud-and-tools/event-monitoring-and-alerts-over… - [Organizations details](https://docs.hologram.io/dashboard/orgs-and-users/organization-overview.md): An organization is the shared account for your company or team. An organization lets you manage a collection of SIMs, and each organization is a single billed entity. Learn about organizations, collaborators, and how to manage access in Hologram. - [Accept an invite to collaborate in an organization](https://docs.hologram.io/dashboard/orgs-and-users/accept-organization-invite.md): How to accept an invitation to collaborate on a Hologram organization - [Invite collaborators](https://docs.hologram.io/dashboard/orgs-and-users/invite-collaborators.md): Add teammates to your organization and choose their access level. - [Change user roles](https://docs.hologram.io/dashboard/orgs-and-users/user-roles.md): Manage team members with access to collaborate in an organization, and limit or grant access to dashboard features with user roles. - [Switch organizations](https://docs.hologram.io/dashboard/orgs-and-users/switch-organizations.md): You have access to multiple organizations in your dashboard, and may need to switch between them to manage your SIMs or collaborate with your team(s). - [Create an organization](https://docs.hologram.io/dashboard/orgs-and-users/create-organization.md): Create a new organization to manage your SIMs and collaborators - [Transfer ownership of an organization](https://docs.hologram.io/dashboard/orgs-and-users/transfer-ownership.md): Sometimes organization ownership needs to be transferred when a user leaves the organization or is no longer able to manage it. This guide outlines the process to follow to transfer ownership to a different user in your organization. - [Delete an organization](https://docs.hologram.io/dashboard/orgs-and-users/delete-organization.md): Deleting organizations can be useful when merging accounts or simplifying your dashboard. Deletion is a manual process that must be requested by the organization owner. Before deleting an organization, you must deactivate or transfer all SIMs and pay any negative balance. - [Update account details](https://docs.hologram.io/dashboard/account/update-account-details.md): Update your name, email address, and password in your account settings. Under the **Settings** page in the main menu, open the **My account** page to update account details, find your API key, and view pending invitations. - [Generate and manage your REST API key](https://docs.hologram.io/dashboard/account/rest-api-key.md): Your API key is your personal access token for the Hologram REST API, and can be managed in the **Settings** page in the main menu, under the **My account** tab. Your API key gives you access to your personal account, as well as any organizations you are a member of. - [Set a default organization](https://docs.hologram.io/dashboard/account/change-default-organization.md): Choose which organization opens by default when you log in. - [Delete your account](https://docs.hologram.io/dashboard/account/delete-account.md): Deleting your account is a manual process. My account must be in good standing without a negative balance, and have no active SIMs. - [Hologram REST API](https://docs.hologram.io/api/v1.md): The Hologram HTTP API is a REST-style interface for managing Hologram SIMs, accounts, and cloud data. Using this API, you can activate SIMs, get your devices' approximate location, send SMS messages to your devices, update data usage limits, and much more. - [Get bulk state change job status](https://docs.hologram.io/api/1/devices/batch/state/get.md): Get the status of all current bulk state change jobs. State changes can take time to process for large numbers of devices. If the org does not have a plan that supports seeing activity history, this endpoint will return a 403. - [List devices](https://docs.hologram.io/api/1/devices/get.md): Retrieve a list of devices with their detailed information including profile information (cellular links), session data, and metadata. The devices are returned sorted by creation date, with the most recent devices appearing first. Use the `limit` and `startafter` parameters together for cursor-based… - [List devices (paginated)](https://docs.hologram.io/api/1/devices/pages/get.md): Retrieve pagination information for devices retrieved from `/devices` for organizations with many devices. This endpoint will return empty data if there are fewer devices than the limit specified. - [Get device count](https://docs.hologram.io/api/1/devices/count/get.md): Returns the total number of devices for the organization. - [Get past active device count](https://docs.hologram.io/api/1/devices/activecount/get.md): Returns the count of devices that were active at a given point in time. - [Get device by ID](https://docs.hologram.io/api/1/devices/deviceid/get.md): Retrieves the details of an existing device. Specify the unique device identifier (device ID) in the request URL, which you can find on the Dashboard. - [Rename or transfer a device](https://docs.hologram.io/api/1/devices/deviceid/put.md): Updates the specified device by setting the values of the parameters passed. Any parameters not provided will be left unchanged. You can change the device's name displayed on the Dashboard. You can also transfer ownership of the device to a different organization. - [Change device state](https://docs.hologram.io/api/1/devices/deviceid/state/post.md): Change the state of a device's SIM card. Supported state values are `pause`, `live`, and `deactivate`. - [Update data usage limit for device](https://docs.hologram.io/api/1/devices/deviceid/usagelimit/post.md): Updates the data usage limit, SMS limit, and data usage alert threshold for a SIM. Values must be >= -1 where -1 means no limit. - [Change data plan for device](https://docs.hologram.io/api/1/devices/deviceid/changeplan/post.md): Change the data plan for the given device. Non-pending paused profiles (PAUSED-USER, PAUSED-SYS) can change plans when the new plan uses the same CSP (no coverage change). Pending paused profiles remain rejected. Warning: Changing data plans will remove any set data limits. - [Get device names](https://docs.hologram.io/api/1/devices/names/get.md): Retrieve a mapping of device IDs to device names for devices in the organization. Returns a paginated list with device IDs as keys and device names as values. - [Get device locations](https://docs.hologram.io/api/1/devices/locations/get.md): Retrieve location information for devices that have reported location data. Returns a paginated list of devices with their most recent location including latitude, longitude, and accuracy range. - [Search for devices](https://docs.hologram.io/api/1/devices/search/post.md) - [List devices with open data sessions](https://docs.hologram.io/api/1/devices/opensessions/get.md): Returns a list of device IDs that currently have an open cellular data session. - [Get device webhook](https://docs.hologram.io/api/1/devices/deviceid/webhook/get.md): Returns the webhook configuration for the specified device. - [Get a devices report for the current organization](https://docs.hologram.io/api/1/reports/devices/get.md) - [List cloud messages](https://docs.hologram.io/api/1/csr/data/get.md): Returns a paginated list of cloud messages - [Single cloud message](https://docs.hologram.io/api/1/csr/data/recordid/get.md): Alias of GET /data/messages/{recordId}. - [Get matching cloud messaging topics/tags](https://docs.hologram.io/api/1/csr/tags/get.md): Returns a paginated list of tags used on device data messages - [Send cloud message to device](https://docs.hologram.io/api/1/devices/messages/post.md): Send a cloud message (data) to one or more devices. Messages can be sent as plain text using the `data` parameter or as base64-encoded content using the `base64data` parameter. Port must be between 1 and 65535. Protocol must be TCP or UDP. Max data size is 10K. - [Activate devices (bulk)](https://docs.hologram.io/api/1/links/cellular/bulkclaim/post.md): Activate SIMs by ICCID range, individual ICCID list, or EID range. Maximum of 2,500 SIMs per request. Once a SIM is activated, you can begin passing data. `plan` and `zone` are required for all live activations. - [Batch change device state](https://docs.hologram.io/api/1/devices/batch/state/post.md): Create a batch job to change the state of a large set of devices. Accepts device IDs directly or a bulk filter criteria. Returns a list of tasks for the batch runner. - [Change device state (bulk)](https://docs.hologram.io/api/1/devices/state/post.md): Change the state of multiple devices at once. Supported state values are `pause`, `live`, and `deactivate`. Pausing the device will prevent your device from passing any data on all SIM profiles. Paused devices still incur Monthly Recurring Charges. Deactivating permanently removes SIM cards from ser… - [Transfer devices to organization (bulk)](https://docs.hologram.io/api/1/devices/transfer/post.md): Transfer devices to a different organization. Maximum of 3000 devices per request. All devices must belong to the same source organization. - [Update data usage limits for devices (bulk)](https://docs.hologram.io/api/1/devices/usagelimit/post.md): Updates the data usage limit, SMS limit, and data usage alert threshold for one or more SIMs. Values must be >= -1 where -1 means no limit. - [Change data plan for devices (bulk)](https://docs.hologram.io/api/1/devices/changeplan/post.md): Change the data plan for the given devices. Non-pending paused profiles (PAUSED-USER, PAUSED-SYS) can change plans when the new plan uses the same CSP (no coverage change). Pending paused profiles remain rejected. Warning: Changing data plans will remove any set data limits. - [Update device names (bulk)](https://docs.hologram.io/api/1/devices/names/post.md): Bulk update device names. Either supply `prefix` to rename each selected device to `{prefix} ({last 5 ICCID digits})` (or the prefix alone when `skipPostfix` is true), or supply `names` to set an explicit name per device. With `prefix`, devices are selected via `deviceids`, bulk-selection filters, o… - [Batch update device usage limits](https://docs.hologram.io/api/1/devices/batch/usagelimit/post.md): Create a batch job to update the usage limits for a large set of devices. Returns a list of tasks for the batch runner. - [List all tags](https://docs.hologram.io/api/1/devices/tags/get.md): Get all tags. If you specify an org, this will only return the tags for the org. - [Create a tag](https://docs.hologram.io/api/1/devices/tags/post.md): Creates a new device tag in the caller's current organization. Devices can optionally be linked to the tag at creation time. - [Rename a tag](https://docs.hologram.io/api/1/devices/tags/tagid/updatetagname/put.md): Update a tag name for the given tag - [Add tag to devices](https://docs.hologram.io/api/1/devices/tags/tagid/link/post.md): Add a tag to specified devices. - [Remove tag from devices](https://docs.hologram.io/api/1/devices/tags/tagid/unlink/post.md): Removes a tag from specified devices. Returns the tag with its remaining linked devices. - [Delete tag](https://docs.hologram.io/api/1/devices/tags/tagid/delete.md): Deletes a tag. If the tag is associated with any SIMs, the tag is removed from those SIMs. - [Send an outbound SMS from a device](https://docs.hologram.io/api/1/sms/outgoing/post.md) - [Route an inbound SMS to the destination device](https://docs.hologram.io/api/1/sms/incoming/post.md): Authenticated endpoint for delivering inbound SMS to a device. - [List tunnel keys for the current user](https://docs.hologram.io/api/1/tunnelkeys/get.md): Returns the authenticated user's tunnel keys. Requires the organization to have tunnel access enabled. - [Create a tunnel key](https://docs.hologram.io/api/1/tunnelkeys/post.md): Creates a new tunnel key. If `public_key` is omitted, the server generates a 2048-bit RSA keypair and returns the private key in the response — save it immediately, it is not stored. The key type must be `ssh-rsa`. At most 5 enabled keys are allowed per user. If the org does not have a plan that sup… - [Disable a tunnel key](https://docs.hologram.io/api/1/tunnelkeys/keyid/disable/post.md) - [Enable a tunnel key](https://docs.hologram.io/api/1/tunnelkeys/keyid/enable/post.md) - [List recent data usage records](https://docs.hologram.io/api/1/usage/data/get.md) - [List daily aggregated data usage](https://docs.hologram.io/api/1/usage/data/daily/get.md) - [List monthly aggregated data usage](https://docs.hologram.io/api/1/usage/data/monthly/get.md) - [Get the last billing period that had usage activity](https://docs.hologram.io/api/1/usage/data/last-period-with-usage/get.md) - [List billing usage records](https://docs.hologram.io/api/1/usage/data/billing/get.md): Returns total data usage for each SIM summarized by the SIM's unique 30-day billing period. Records are returned per link (profile) ID by billing period, within the date range specified. Monthly Recurring Charges are billed every 30 days beginning at the time the device was activated. Data is availa… - [Get aggregated total data usage](https://docs.hologram.io/api/1/usage/data/total/get.md) - [List SMS usage records](https://docs.hologram.io/api/1/usage/sms/get.md) - [List SIM configurations](https://docs.hologram.io/api/1/simcards/configurations/get.md): Returns available sim configurations based on the plans visible to all of a user's orgs. Optionally filter specific configurations with the parameters below. - [Get a single SIM configuration](https://docs.hologram.io/api/1/simcards/configurations/simconfigurationid/get.md): Get a single SIM configuration via its id. Optionally provide an orgid or plan_ids to validate a configuration is applicable. - [Apply a SIM configuration to one or more SIM cards](https://docs.hologram.io/api/1/simcards/configure/post.md): Dispatches a configuration change to the specified SIM cards. Non-admin users may only target SIM cards they can access and configurations allowed by their plan. - [Apply a SIM configuration to a single SIM card](https://docs.hologram.io/api/1/simcards/simcardid/configure/post.md): Dispatches a configuration change to the specified SIM card. Non-admin users may only target a SIM card they can access and configurations allowed by their plan. - [List organizations](https://docs.hologram.io/api/1/organizations/get.md): List organizations. Returns all organizations that you are a member of. This includes the personal organization tied to your user. When you create your Hologram account, a personal organization associated solely with your account is also created. This personal org is named after you. You cannot add… - [Create organization](https://docs.hologram.io/api/1/organizations/post.md): Create a new organization - [Get an organization](https://docs.hologram.io/api/1/organizations/orgid/get.md): Get organization details - [List pending invites](https://docs.hologram.io/api/1/organizations/pending/get.md): Get all the pending invites for an organization - [List billing statements for an organization](https://docs.hologram.io/api/1/organizations/orgid/statements/get.md): Get billing statement records that match the passed in parameters - [Download a billing statement as a CSV file](https://docs.hologram.io/api/1/organizations/orgid/statements/statementid/csv/get.md): Get a billing statement stream from DB (regenerated CSV) - [Get organization billing configuration](https://docs.hologram.io/api/1/organizations/orgid/billing/get.md): Get billing info for the organization - [Get organization account balance](https://docs.hologram.io/api/1/organizations/orgid/balance/get.md) - [List balance history for an organization](https://docs.hologram.io/api/1/organizations/orgid/balancehistory/get.md) - [List data plans](https://docs.hologram.io/api/1/plans/get.md): List all data plans. Returns all data plans matching the specified parameters. - [Get data plan](https://docs.hologram.io/api/1/plans/planid/get.md): Retrieves the details of a specific data plan. - [Get data plan inventory for organization](https://docs.hologram.io/api/1/organizations/orgid/devices/plans/get.md): Returns a summary of device data plan distribution for an organization. - [Get all data plan pricing](https://docs.hologram.io/api/1/plans/pricing/get.md): Get pricing for a plan. Retrieves the pricing details of available plans. - [List users](https://docs.hologram.io/api/1/users/get.md) - [Get a user by ID](https://docs.hologram.io/api/1/users/userid/get.md) - [Update a user](https://docs.hologram.io/api/1/users/userid/post.md) - [Get the currently authenticated user](https://docs.hologram.io/api/1/users/me/get.md) - [Get the current user's API key](https://docs.hologram.io/api/1/users/me/apikey/get.md) - [Generate a new API key for the current user](https://docs.hologram.io/api/1/users/me/apikey/post.md) - [List async change requests](https://docs.hologram.io/api/1/asyncchangerequests/get.md): Returns a paginated list of async change requests. Async change requests represent background operations such as plan changes and SIM configuration updates that are processed asynchronously. Non-super-admin callers only receive requests for organizations they can access. - [Get a single async change request by ID](https://docs.hologram.io/api/1/asyncchangerequests/requestid/get.md): Returns the full detail for a single async change request, including its child request IDs and decoded metadata. - [Update SIM location via carrier backend](https://docs.hologram.io/api/1/links/cellular/updatelocation/post.md): Triggers a location update for the matching SIMs via the carrier backend. Requires access to the specified links. Not supported by all carriers. Only links in a LIVE, TEST-ACTIVATE, or TEST-AUTOACTIVATE network state are eligible — every other state, including any state not listed here, is blocked. - [Get current billing period usage for a SIM card](https://docs.hologram.io/api/1/usage/billing/simcard/simcardid/get.md): Returns one aggregate usage record for a SIM's current unique 30-day billing period. Optionally restrict the total to one cellular link; linkids identifies all links included in the aggregate. - [Hologram Release Notes](https://docs.hologram.io/release-notes/release-notes-2026.md): Keep up with the latest Hologram product and API updates. - [Hologram Release Notes](https://docs.hologram.io/release-notes/release-notes-2025.md): Keep up with the latest Hologram product and API updates. - [Hologram Release Notes - 2024](https://docs.hologram.io/release-notes/release-notes-2024.md): Keep up with the latest Hologram product and API updates. ## OpenAPI Specs - [openapi](/api/1/openapi.yaml)