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

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

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 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-02-13** `6b77b7d523c8`: 4 info
- **2025-12-16** `09c4a210c4f4`: 1 info
- **2025-12-03** `cefb61d3a50d`: 2 breaking, 5 info
- **2025-12-03** `6d37edc8f6de`: 1 info
- **2025-12-03** `a19e4e048390`: 4 breaking, 3 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 `data/items/total_fw_updates` to the response with the `200` status
  - added the optional property `data/items/total_reboots` to the response with the `200` status
- **2026-02-13** `6b77b7d523c8`: 4 info
  - added the new optional `query` request parameter `limit`
  - added the optional property `data/items/billable_events` to the response with the `200` status
  - added the optional property `data/items/total_days_in_period` to the response with the `200` status
  - added the optional property `truncated` to the response with the `200` status
- **2025-12-16** `09c4a210c4f4`: 1 info
  - added the required property `data/items/total_devices` to the response with the `200` status
- **2025-12-03** `cefb61d3a50d`: 2 breaking, 5 info
  - the `query` request parameter `aggregate` was restricted to a list of enum values
  - for the `query` request parameter `aggregate`, default value `device` was added
  - added the new optional `query` request parameter `includeNotefiles`
  - added the new enum value `device` to the `query` request parameter `aggregate`
  - added the new enum value `fleet` to the `query` request parameter `aggregate`
  - added the new enum value `project` to the `query` request parameter `aggregate`
  - for the `query` request parameter `aggregate`, the type was generalized from `array` to `string`
- **2025-12-03** `6d37edc8f6de`: 1 info
  - added the new optional `query` request parameter `skipRecentData`
- **2025-12-03** `a19e4e048390`: 4 breaking, 3 info
  - for the `query` request parameter `aggregate`, default value `device` was removed
  - removed the enum value `device` from the `query` request parameter `aggregate`
  - removed the enum value `fleet` from the `query` request parameter `aggregate`
  - removed the enum value `project` from the `query` request parameter `aggregate`
  - added the new optional `query` request parameter `notefile`
  - for the `query` request parameter `aggregate`, the type was generalized from `string` to `array`
  - added the optional property `data/items/notefiles` to the response with the `200` status

---

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