---
title: "Changes to Get Inference Usage Aggregate"
method: GET
path: "/v2/usage/inference"
---

# Changes to Get Inference Usage Aggregate

`GET /v2/usage/inference`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 37 revisions.

- **2026-10-09** `76e7e99cfcd1`: 2 info
- **2026-10-04** `43b27d9934b5`: 1 info
- **2026-09-21** `74fedf0c50ba`: 2 warning
- **2026-09-18** `24ae0ec2fcc1`: 8 breaking
- **2026-09-16** `05b868460954`: 1 breaking, 9 info

## Changes

- **2026-10-09** `76e7e99cfcd1`: 2 info
  - added the non-success response with the status `429`
  - added the non-success response with the status `503`
- **2026-10-04** `43b27d9934b5`: 1 info
  - added the optional property `buckets/items/groups/items/qa_analysis` to the response with the `200` status
- **2026-09-21** `74fedf0c50ba`: 2 warning
  - removed the optional property `errors/items/ctx` from the response with the `422` status
  - removed the optional property `errors/items/input` from the response with the `422` status
- **2026-09-18** `24ae0ec2fcc1`: 8 breaking
  - `query` request parameter `group_by` list-of-types was narrowed by removing types `string`
  - removed the enum value `api_key` from the property `anyOf[subschema #1]/` of the `query` request parameter `group_by`
  - removed the enum value `byok` from the property `anyOf[subschema #1]/` of the `query` request parameter `group_by`
  - removed the enum value `model` from the property `anyOf[subschema #1]/` of the `query` request parameter `group_by`
  - removed the enum value `route` from the property `anyOf[subschema #1]/` of the `query` request parameter `group_by`
  - removed the enum value `user` from the property `anyOf[subschema #1]/` of the `query` request parameter `group_by`
  - for the `query` request parameter `group_by`, the type of property `anyOf[subschema #1]/` was specialized from `string` to `array`
  - response property `group_by` list-of-types was widened by adding types `array` to media type `application/json` of response `200`
- **2026-09-16** `05b868460954`: 1 breaking, 9 info
  - the `detail` response's property type changed from `array` to `string` for status `422`
  - the response property `detail` became required for the status `422`
  - added the required property `error` to the response with the `422` status
  - added the required property `errors` to the response with the `422` status
  - added the required property `source` to the response with the `400` status
  - added the required property `source` to the response with the `401` status
  - added the required property `source` to the response with the `403` status
  - added the required property `source` to the response with the `404` status
  - added the required property `source` to the response with the `409` status
  - added the required property `source` to the response with the `422` status

---

[Operation](https://skmtc.dev/hud/apis/hud-platform/docs/v2/usage/inference/get.md) - [API](https://skmtc.dev/hud/apis/hud-platform.md) - [Page](https://skmtc.dev/hud/apis/hud-platform/changes/v2/usage/inference/get)