---
title: "List recent data usage records"
method: GET
path: "/usage/data/"
tags: ["SIMs (Devices)"]
---

# List recent data usage records

`GET /usage/data/`

## Request

- Base URL: `https://dashboard.hologram.io/api/1`
- URL: `https://dashboard.hologram.io/api/1/usage/data/`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/hologram/apis/hologram-rest-api-v1/docs/usage/data/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `limit` integer
- `before` integer
- `after` integer
- `linkid` integer
- `linkids` string
- `tagids` string
- `timestart` integer
- `timeend` integer
- `islive` boolean
- `getdeviceinfo` boolean
- `getplaninfo` boolean
- `getprofileinfo` boolean
- `getcountryinfo` boolean
- `getlocationinfo` boolean
- `startafter` integer
- `higherthanid` integer
- `simcardids` string
- `tagid` integer
- `tagname` string

## Response `200`

OK

- UsageDataListResponse
  - `success` boolean: Indicates whether the request was successful.
  - `limit` integer: Maximum number of records returned per page
  - `size` integer: Number of records in this response
  - `continues` boolean: True if more records are available
  - `lastid` integer: record_id of the last record returned; pass as startafter to fetch the next page
  - `links` PaginationLinks
    - `path` string: The API endpoint path
    - `base` string: The API base URL
    - `next` string: URL to retrieve the next page of results
  - `data` UsageDataRecord[]
    - `linkid` integer: Cellular link (SIM) ID
    - `record_id` integer: Unique usage record ID, used for cursor-based pagination
    - `session_begin` string: Session start time (UTC)
    - `timestamp` string: Session end time (UTC)
    - `bytes` integer: Bytes transferred in this session
    - `imeisv` string: Raw IMEISV (15-digit IMEI + 2-digit software version)
    - `imei` string: IMEI derived from the IMEISV
    - `cellid` integer: Cell tower ID
    - `lac` integer: Location Area Code
    - `radio_access_technology` string: Radio access technology (e.g. LTE, 3G)
    - `network_name` string: Carrier network name
    - `sim` string: SIM ICCID
    - `simcardid` integer: SIM card ID
    - `data_plan_id` integer: Data plan subscription ID active during this session
    - `tags` string[]: Device tags at time of record
    - `country` string: Country code (present when getcountryinfo=true)
    - `profile_name` string: SIM profile name (present when getprofileinfo=true)
    - `latitude` number, nullable: Approximate latitude (present when getlocationinfo=true)
    - `longitude` number, nullable: Approximate longitude (present when getlocationinfo=true)

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/hologram/apis/hologram-rest-api-v1.md) - [All operations](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/revisions/1bc07dcd1631?raw)