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

# Single SIM data usage reports

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

## Where can I find data usage reports for a single SIM?

Find your SIM from the **SIMs** pages or using **search**. The **Recent sessions** tab contains a live view of recent sessions. The **Data usage** tab contains a detailed historical reporting.

## Recent sessions

For a live view of recent, closed sessions, find your SIM from the SIMs pages or using search, and open the **Recent sessions** tab. This page contains a data visualization of recent sessions over time, useful for understanding the connectivity behavior of your SIM.

![Recent sessions chart showing session activity over time](https://mintcdn.com/hologram-b29df2a6/gBXuuJ66IPyI_nhw/images/usage/usage-sim-recent-sessions.webp?fit=max\&auto=format\&n=gBXuuJ66IPyI_nhw\&q=85\&s=5dece41ddffc91c9964764f493916388)

**Export session data** in XLSX, CSV, or JSON formats using the **Export menu** in the top right of the Recent sessions card. JSON exports have additional fields not contained in spreadsheet formats.

> [!NOTE]
>
> **Note:** For your security, Hologram only operates with session metadata. If you want to dive even deeper into your usage you'd need to use a device side network analyzer tool like [tshark](https://www.wireshark.org/dashboard/man-pages/tshark.html) or [bmon](https://www.linux.com/learn/bmon-powerful-network-bandwidth-monitoring-and-debugging-tool-linux).

## Data usage reports

Detailed session-level data usage for a SIM is found in the **Data usage tab**. These reports default to displaying all data usage for the SIM's current billing period, and mirror the fleet-level data usage reporting available in the **[Usage](https://docs.hologram.io/dashboard/usage/usage-overview.md)** section of your dashboard.

### Data usage details

Find summarized data usage within the selected date for a SIM card by network, profile, or day to understand overall data usage behavior and connectivity changes, and to identify possible device configuration problems from zero-byte sessions.

> [!NOTE]
>
> **Note:** Data within our detailed data usage reports refresh hourly, and may not contain the most recent sessions for a SIM.

* **Data usage by network** - Total data usage broken down by network and profile.
* **Data usage by profile** - Total data usage by profile, especially useful for SIMs with multiple installed profiles and Outage Protection™.
* **Data usage by day** - Total data usage broken down by day.

![Data usage details report](https://mintcdn.com/hologram-b29df2a6/gBXuuJ66IPyI_nhw/images/usage/usage-sim-data-usage.webp?fit=max\&auto=format\&n=gBXuuJ66IPyI_nhw\&q=85\&s=616965988c7a85928f42add968c71bfa)

#### Key metrics and terms

> [accordion] View key metrics and terms
>
> **Data usage for range (MB)**
>
> Total data usage for the selected date range in a readable format.
>
> **Data usage for range (bytes)**
>
> Total data usage for the selected date range in bytes.
>
> **Productive sessions**
>
> Total number of closed sessions in which data was passed through a network.
>
> **Zero-byte sessions**
>
> Total number of sessions in which no data was passed through a network, indicating possible device configuration issues.
>
> **Outbound SMS**
>
> Total number of device-originated SMS messages sent from the SIM that count toward a SIM's SMS limit.

### Location history report

Detailed data usage broken down by location with a map of approximate device location. Data usage is categorized by region, country, network, tower, and latitude and longitude.

### Session history report

Detailed session-level historical data usage information for a SIM. Detailed data and filtering helps you identify exact issues and pinpoint exactly where and why problems occurred.

![Session history report](https://mintcdn.com/hologram-b29df2a6/gBXuuJ66IPyI_nhw/images/usage/usage-report-sim-session-history.webp?fit=max\&auto=format\&n=gBXuuJ66IPyI_nhw\&q=85\&s=b6365d516a5b5e04762d7e64fb114616)

#### Field descriptions

> [accordion] View field descriptions
>
> **End time (UTC)**
>
> Date/time in UTC the data session ended. Data usage reporting references this date as when data was “used” and billed.
>
> **Start time (UTC)**
>
> Date/time in UTC the data session started.
>
> **Duration (seconds)**
>
> Duration in seconds the session lasted.
>
> **Data usage**
>
> Total data usage for the session in a readable format.
>
> **Data usage (bytes)**
>
> Total data usage for the session in bytes.
>
> **Type**
>
> Session or reporting windows if the carrier returns data in timed blocks.
>
> **Network**
>
> Name of the network used to pass data.
>
> **RAT**
>
> Radio access technology used.
>
> **Country**
>
> Country the cellular tower was located within.
>
> **Tower ID**
>
> Cellular tower ID as returned by the carrier, if provided.
>
> **Approximate lat/long**
>
> Crowdsourced tower location, if provided.
>
> **Profile ICCID**
>
> ICCID of the connectivity profile used to connect.
>
> **Profile name**
>
> Name of the profile used to connect.
>
> **SIM ID**
>
> ID of the SIM card.
>
> **IMEI**
>
> IMEI of the modem the SIM card connected through, if provided by the carrier and network.
>
> **Data plan name**
>
> Data plan active on the SIM at the time the session closed, useful for identifying when a change in rates occurred.

## Data availability

Recent data usage is available for the last 90 days and is reported in near-real-time. Historical data usage is available for at least 365 days and is updated every 60 minutes. Historical data usage is available to all contracted accounts, and self-service accounts with over \$100 USD in monthly recurring charges.

## Data usage reporting using the REST API

Limited data usage reporting is also available [through the REST API](https://docs.hologram.io/api/v1.md). The `/usage` endpoints retrieve usage per profile using the link ID found in the Profiles tab.

> [card] [List recent data sessions](https://docs.hologram.io/api/1/usage/data/get.md)
>
> List recent data sessions `GET /usage/data`

> [card] [List total usage for billing period](https://docs.hologram.io/api/1/usage/data/monthly/get.md)
>
> List total usage for billing period `GET /usage/data/monthly`

> [card] [List outbound SMS usage](https://docs.hologram.io/api/1/usage/sms/get.md)
>
> List outbound SMS usage `GET /usage/sms`

## Related guides

> [card] [Single SIM details page](https://docs.hologram.io/dashboard/sims/sim-details-overview.md)
>
> Read more about the SIM details page and all the information you can find there.

> [card] [SIM actions](https://docs.hologram.io/dashboard/sim-actions/single-sim-actions-overview.md)
>
> Learn more about the actions you can take on a single SIM.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.