---
title: "Changes to Query and filter usage data"
method: POST
path: "/organizations/{orgId}/usage/query"
---

# Changes to Query and filter usage data

`POST /organizations/{orgId}/usage/query`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 11 revisions.

- **2026-10-16** `85c514abc692`: 2 breaking
- **2025-08-01** `9f9e5f3dbde7`: 1 breaking, 4 info
- **2025-02-21** `d064a12d0d93`: 1 info

## Changes

- **2026-10-16** `85c514abc692`: 2 breaking
  - the `aggregations/items/fieldType/allOf[subschema #2]/` request property type changed from no type to `object`
  - the `aggregations/items/function/allOf[subschema #2]/` request property type changed from no type to `object`
- **2025-08-01** `9f9e5f3dbde7`: 1 breaking, 4 info
  - removed `#/components/schemas/DataExplorerAccountGroup, #/components/schemas/DataExplorerDimensionGroup, #/components/schemas/DataExplorerTimeGroup` from the `groups/items/` request property `oneOf` list
  - added the new optional request property `groups/items/groupType`
  - the request property `allOf[#/components/schemas/RequestWithStartAndEndDate]/endDate` became optional
  - the request property `allOf[#/components/schemas/RequestWithStartAndEndDate]/startDate` became optional
  - added discriminator to `groups/items/` request property
- **2025-02-21** `d064a12d0d93`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/m3ter-com/apis/m3ter-api/docs/organizations/:orgId/usage/query/post.md) - [API](https://skmtc.dev/m3ter-com/apis/m3ter-api.md) - [Page](https://skmtc.dev/m3ter-com/apis/m3ter-api/changes/organizations/:orgId/usage/query/post)