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

# GET /v1/projects/{projectOrProductUID}/devices/{deviceUID}/sessions

`GET /v1/projects/{projectOrProductUID}/devices/{deviceUID}/sessions`

Get Device Sessions

## Path parameters

- `projectOrProductUID` string, required
- `deviceUID` string, required

## Query parameters

- `pageSize` integer
- `pageNum` integer
- `startDate` integer
- `endDate` integer
- `firstSync` boolean

## Response `200`

The response body for a session request.

- object
  - `has_more` boolean, required
  - `sessions` DeviceSession[], required
    - `apn` string
    - `bars` integer
    - `bearer` string
    - `bssid` string
    - `cell` string — Cell ID where the session originated and quality ("mcc,mnc,lac,cellid")
    - `continuous` boolean — Was this a continuous connection?
    - `device` string — Device UID
    - `events` integer — Number of events routed
    - `failed_connects` integer — Number of failed connection attempts in the prior session
    - `fleets` string[] — Array of Fleet UIDs
    - `hp_cycles_data` integer
    - `hp_cycles_gps` integer
    - `hp_cycles_total` integer
    - `hp_secs_data` integer
    - `hp_secs_gps` integer
    - `hp_secs_total` integer — Total number of seconds in high power mode
    - `iccid` string
    - `ip` string
    - `moved` integer
    - `orientation` string
    - `penalty_secs` integer — Number of seconds in penalty in the prior session
    - `period` DeviceUsage
      - `bytes_rcvd` integer
      - `bytes_rcvd_secondary` integer
      - `bytes_sent` integer
      - `bytes_sent_secondary` integer
      - `duration` integer — Duration in seconds
      - `notes_rcvd` integer
      - `notes_sent` integer
      - `sessions_tcp` integer
      - `sessions_tls` integer
      - `since` integer — Unix timestamp
    - `power_charging` boolean
    - `power_mah` number, double
    - `power_primary` boolean
    - `power_usb` boolean
    - `product` string — Product UID
    - `rat` string
    - `rsrp` integer
    - `rsrq` integer
    - `rssi` integer
    - `scan` string, byte
    - `session` string — Session UID
    - `session_began` integer — UNIX timestamp of session start
    - `session_ended` integer — UNIX timestamp of session end
    - `sinr` integer
    - `sn` string — Device Serial Number
    - `ssid` string
    - `temp` number, double
    - `tls` boolean — Was TLS used?
    - `tower` TowerLocation
      - `c` string — Country code
      - `cid` integer — Cell ID
      - `l` string — Open Location Code
      - `lac` integer — Location Area Code
      - `lat` number, double — Latitude
      - `lon` number, double — Longitude
      - `mcc` integer — Mobile Country Code
      - `mnc` integer — Mobile Network Code
      - `n` string — Name of the location
      - `source` string — The source of this location
      - `time` integer — Unix timestamp when this location was ascertained
      - `towers` integer — Number of triangulation points
      - `z` integer — Timezone ID
      - `zone` string — Timezone name
    - `transport` string — Type of network transport
    - `tri` TowerLocation
      - `c` string — Country code
      - `cid` integer — Cell ID
      - `l` string — Open Location Code
      - `lac` integer — Location Area Code
      - `lat` number, double — Latitude
      - `lon` number, double — Longitude
      - `mcc` integer — Mobile Country Code
      - `mnc` integer — Mobile Network Code
      - `n` string — Name of the location
      - `source` string — The source of this location
      - `time` integer — Unix timestamp when this location was ascertained
      - `towers` integer — Number of triangulation points
      - `z` integer — Timezone ID
      - `zone` string — Timezone name
    - `triangulate` object
    - `usage_actual` boolean
    - `voltage` number, double
    - `when` integer — Last known capture time of a note routed through this session in Unix timestamp
    - `where` string — Open Location Code from last GPS location
    - `where_country` string
    - `where_lat` number, double
    - `where_location` string
    - `where_lon` number, double
    - `where_timezone` string
    - `where_when` integer — Unix timestamp of last GPS location
    - `why_session_closed` string — Reason for session closing
    - `why_session_opened` string — Reason for session opening
    - `work` integer — Unix timestamp of the last time work was done for this session

## Other responses

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

## Changes

- **2026-07-10** `1887e880199a` — 1 breaking, 6 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `default`
  - added the optional property `debug` to the response with the `default` status
  - added the optional property `details` to the response with the `default` status
  - added the optional property `request` to the response with the `default` status
  - …3 more
- **2026-07-07** `b51b37d660fc` — 2 breaking
  - for the `query` request parameter `endDate`, the type/format was changed from `integer`/`` to `integer`/`int64`
  - for the `query` request parameter `startDate`, the type/format was changed from `integer`/`` to `integer`/`int64`
- **2026-02-26** `e9b880497243` — 1 info
  - added the new optional `query` request parameter `firstSync`

[Change history](https://skmtc.dev/notefile/apis/notehub-api/changes/v1/projects/:projectOrProductUID/devices/:deviceUID/sessions/get.md)

---

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