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

<Frame>
  <img src="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" alt="Recent sessions chart showing session activity over time" width="2481" height="1946" data-path="images/usage/usage-sim-recent-sessions.webp" />
</Frame>

**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).
</Note>

## 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](/dashboard/usage/usage-overview)** 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.
</Note>

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

<Frame>
  <img src="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" alt="Data usage details report" width="1202" height="1105" data-path="images/usage/usage-sim-data-usage.webp" />
</Frame>

#### Key metrics and terms

<Accordion title="View key metrics and terms">
  <ResponseField name="Data usage for range (MB)">
    Total data usage for the selected date range in a readable format.
  </ResponseField>

  <ResponseField name="Data usage for range (bytes)">
    Total data usage for the selected date range in bytes.
  </ResponseField>

  <ResponseField name="Productive sessions">
    Total number of closed sessions in which data was passed through a network.
  </ResponseField>

  <ResponseField name="Zero-byte sessions">
    Total number of sessions in which no data was passed through a network, indicating possible device configuration issues.
  </ResponseField>

  <ResponseField name="Outbound SMS">
    Total number of device-originated SMS messages sent from the SIM that count toward a SIM's SMS limit.
  </ResponseField>
</Accordion>

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

<Frame>
  <img src="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" alt="Session history report" width="2194" height="1870" data-path="images/usage/usage-report-sim-session-history.webp" />
</Frame>

#### Field descriptions

<Accordion title="View field descriptions">
  <ResponseField name="End time (UTC)">
    Date/time in UTC the data session ended. Data usage reporting references this date as when data was “used” and billed.
  </ResponseField>

  <ResponseField name="Start time (UTC)">
    Date/time in UTC the data session started.
  </ResponseField>

  <ResponseField name="Duration (seconds)">
    Duration in seconds the session lasted.
  </ResponseField>

  <ResponseField name="Data usage">
    Total data usage for the session in a readable format.
  </ResponseField>

  <ResponseField name="Data usage (bytes)">
    Total data usage for the session in bytes.
  </ResponseField>

  <ResponseField name="Type">
    Session or reporting windows if the carrier returns data in timed blocks.
  </ResponseField>

  <ResponseField name="Network">
    Name of the network used to pass data.
  </ResponseField>

  <ResponseField name="RAT">
    Radio access technology used.
  </ResponseField>

  <ResponseField name="Country">
    Country the cellular tower was located within.
  </ResponseField>

  <ResponseField name="Tower ID">
    Cellular tower ID as returned by the carrier, if provided.
  </ResponseField>

  <ResponseField name="Approximate lat/long">
    Crowdsourced tower location, if provided.
  </ResponseField>

  <ResponseField name="Profile ICCID">
    ICCID of the connectivity profile used to connect.
  </ResponseField>

  <ResponseField name="Profile name">
    Name of the profile used to connect.
  </ResponseField>

  <ResponseField name="SIM ID">
    ID of the SIM card.
  </ResponseField>

  <ResponseField name="IMEI">
    IMEI of the modem the SIM card connected through, if provided by the carrier and network.
  </ResponseField>

  <ResponseField name="Data plan name">
    Data plan active on the SIM at the time the session closed, useful for identifying when a change in rates occurred.
  </ResponseField>
</Accordion>

## 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](/api/v1). The `/usage` endpoints retrieve usage per profile using the link ID found in the Profiles tab.

<Card title="List recent data sessions" href="/api/1/usage/data/get">
  List recent data sessions <code>GET /usage/data</code>
</Card>

<Card title="List total usage for billing period" href="/api/1/usage/data/monthly/get">
  List total usage for billing period <code>GET /usage/data/monthly</code>
</Card>

<Card title="List outbound SMS usage" href="/api/1/usage/sms/get">
  List outbound SMS usage <code>GET /usage/sms</code>
</Card>

## Related guides

<Card title="Single SIM details page" href="/dashboard/sims/sim-details-overview">
  Read more about the SIM details page and all the information you can find there.
</Card>

<Card title="SIM actions" href="/dashboard/sim-actions/single-sim-actions-overview">
  Learn more about the actions you can take on a single SIM.
</Card>