---
title: "Changes to GET /v1/projects/{projectOrProductUID}/usage/sessions"
method: GET
path: "/v1/projects/{projectOrProductUID}/usage/sessions"
---

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

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 79 revisions.

- **2026-10-02** `1f4693048cb8`: 1 breaking
- **2026-07-30** `1887e880199a`: 1 breaking, 6 info
- **2026-07-30** `b51b37d660fc`: 2 breaking
- **2026-04-07** `31a8d1f882c6`: 2 info
- **2026-04-07** `e9b880497243`: 1 info
- **2026-02-13** `6b77b7d523c8`: 2 info
- **2025-12-16** `09c4a210c4f4`: 1 info
- **2025-12-03** `6d37edc8f6de`: 1 info

## Changes

- **2026-10-02** `1f4693048cb8`: 1 breaking
  - for the `query` request parameter `limit`, the format changed from no format to `int32`
- **2026-07-30** `1887e880199a`: 1 breaking, 6 info
  - the response's body type changed from no type 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
  - added the required property `code` to the response with the `default` status
  - added the required property `err` to the response with the `default` status
  - added the required property `status` to the response with the `default` status
- **2026-07-30** `b51b37d660fc`: 2 breaking
  - for the `query` request parameter `endDate`, the format changed from no format to `int64`
  - for the `query` request parameter `startDate`, the format changed from no format to `int64`
- **2026-04-07** `31a8d1f882c6`: 2 info
  - added the optional property `sessions/items/sessions_by_transport` to the response with the `200` status
  - added the optional property `sessions/items/tls_sessions` to the response with the `200` status
- **2026-04-07** `e9b880497243`: 1 info
  - added the required property `sessions/items/first_sync_sessions` to the response with the `200` status
- **2026-02-13** `6b77b7d523c8`: 2 info
  - added the new optional `query` request parameter `limit`
  - added the required property `truncated` to the response with the `200` status
- **2025-12-16** `09c4a210c4f4`: 1 info
  - added the required property `sessions/items/total_devices` to the response with the `200` status
- **2025-12-03** `6d37edc8f6de`: 1 info
  - added the new optional `query` request parameter `skipRecentData`

---

[Operation](https://skmtc.dev/notefile/apis/notehub-api/docs/v1/projects/:projectOrProductUID/usage/sessions/get.md) - [API](https://skmtc.dev/notefile/apis/notehub-api.md) - [Page](https://skmtc.dev/notefile/apis/notehub-api/changes/v1/projects/:projectOrProductUID/usage/sessions/get)