---
title: "GET /v1/projects/{projectOrProductUID}/usage/data"
method: GET
path: "/v1/projects/{projectOrProductUID}/usage/data"
tags: ["usage"]
---

# GET /v1/projects/{projectOrProductUID}/usage/data

`GET /v1/projects/{projectOrProductUID}/usage/data`

Get data usage in bytes for a project with time range and period aggregation

## Path parameters

- `projectOrProductUID` string, required

## Query parameters

- `startDate` integer
- `endDate` integer
- `deviceUID` string[]
- `fleetUID` string[]
- `limit` integer
- `period` 'day' | 'week' | 'month', required
- `aggregate` 'device' | 'fleet' | 'project'

## Response `200`

Response body for Data Usage

- object
  - `data` object[]
    - `data` UsageData[], required
      - `billable_bytes_total` integer — Total billable bytes (only for packet-based protocols)
      - `downlink_bytes` integer
      - `downlink_bytes_billable` integer — Billable downlink bytes (only for packet-based protocols)
      - `downlink_packets` integer — Downlink packets (only for packet-based protocols)
      - `period` string, date-time, required
      - `total_bytes` integer, required
      - `uplink_bytes` integer
      - `uplink_bytes_billable` integer — Billable uplink bytes (only for packet-based protocols)
      - `uplink_packets` integer — Uplink packets (only for packet-based protocols)
    - `device` string — The device UID this usage data belongs to (only present when aggregate is 'device')
    - `device_count` integer — the number of devices represented by this data point
    - `fleet` string — The fleet UID this usage data belongs to (only present when aggregate is 'fleet')
    - `iccid` string — The ICCID of the cellular SIM card (only present when type is 'cellular')
    - `psid` string — The PSID (Packet Service ID) of the satellite (or other packet-based device)
    - `type` 'cellular' | 'satellite', required — The type of connectivity
  - `truncated` boolean — If the data is truncated that means that the parameters selected resulted in a response of over | the requested limit of data points, in order to ensure

## Other responses

- `default` — The response body in case of an API error.

---

[API](https://skmtc.net/notefile/apis/notehub-api.md) · [All operations](https://skmtc.net/notefile/apis/notehub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notefile/notehub-api/revisions/9c5b2b63a991/schema)