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

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

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

Get sessions usage for a project with time range and period aggregation, when endDate is 0 or unspecified the current time is implied

## 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'
- `skipRecentData` boolean

## Response `200`

Response body for Session Usage

- object
  - `sessions` UsageSessionsData[], required
    - `device` string
    - `first_sync_sessions` integer, required — Number of first sync sessions in this period
    - `fleet` string
    - `period` string, date-time, required
    - `sessions` integer, required
    - `sessions_by_transport` object — Count of sessions grouped by transport type prefix (e.g. cell, wifi, ntn, lorawan)
    - `tls_sessions` integer, nullable — Number of TLS sessions in this period
    - `total_bytes` integer, required
    - `total_devices` integer, required
  - `truncated` boolean, required — 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)