---
title: "Changes to GET /usage/files"
method: GET
path: "/usage/files"
---

# Changes to GET /usage/files

`GET /usage/files`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 12 revisions.

- **2025-05-17** `2de715cbd1f3`: 1 breaking, 22 info
- **2023-12-01** `22a697bcb678`: 7 breaking, 16 warning
- **2022-12-08** `86adefb0bb29`: 1 breaking, 22 info
- **2022-06-30** `6118e3620603`: 2 info

## Changes

- **2025-05-17** `2de715cbd1f3`: 1 breaking, 22 info
  - the `items/` response's property type changed from no type to `object` for status `200`
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `offset`
  - added the media type `application/json` for the response with the status `400`
  - added the optional property `items/acceptance_note` to the response with the `200` status
  - added the optional property `items/currency` to the response with the `200` status
  - added the optional property `items/description` to the response with the `200` status
  - added the optional property `items/environment` to the response with the `200` status
  - added the optional property `items/error_detail` to the response with the `200` status
  - added the optional property `items/events` to the response with the `200` status
  - added the optional property `items/id` to the response with the `200` status
  - added the optional property `items/name` to the response with the `200` status
  - added the optional property `items/period` to the response with the `200` status
  - added the optional property `items/product` to the response with the `200` status
  - added the optional property `items/rejection_note` to the response with the `200` status
  - added the optional property `items/schema` to the response with the `200` status
  - added the optional property `items/stats` to the response with the `200` status
  - added the optional property `items/status` to the response with the `200` status
  - added the required property `items/contract` to the response with the `200` status
  - added the required property `items/external_id` to the response with the `200` status
  - added the required property `items/marketplace` to the response with the `200` status
  - added the required property `items/provider` to the response with the `200` status
  - added the required property `items/vendor` to the response with the `200` status
- **2023-12-01** `22a697bcb678`: 7 breaking, 16 warning
  - removed the media type `application/json` for the response with the status `400`
  - the `items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `items/contract` from the response with the `200` status
  - removed the required property `items/external_id` from the response with the `200` status
  - removed the required property `items/marketplace` from the response with the `200` status
  - removed the required property `items/provider` from the response with the `200` status
  - removed the required property `items/vendor` from the response with the `200` status
  - deleted the `query` request parameter `limit`
  - deleted the `query` request parameter `offset`
  - removed the optional property `items/acceptance_note` from the response with the `200` status
  - removed the optional property `items/currency` from the response with the `200` status
  - removed the optional property `items/description` from the response with the `200` status
  - removed the optional property `items/environment` from the response with the `200` status
  - removed the optional property `items/error_detail` from the response with the `200` status
  - removed the optional property `items/events` from the response with the `200` status
  - removed the optional property `items/id` from the response with the `200` status
  - removed the optional property `items/name` from the response with the `200` status
  - removed the optional property `items/period` from the response with the `200` status
  - removed the optional property `items/product` from the response with the `200` status
  - removed the optional property `items/rejection_note` from the response with the `200` status
  - removed the optional property `items/schema` from the response with the `200` status
  - removed the optional property `items/stats` from the response with the `200` status
  - removed the optional property `items/status` from the response with the `200` status
- **2022-12-08** `86adefb0bb29`: 1 breaking, 22 info
  - the `items/` response's property type changed from no type to `object` for status `200`
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `offset`
  - added the media type `application/json` for the response with the status `400`
  - added the optional property `items/acceptance_note` to the response with the `200` status
  - added the optional property `items/currency` to the response with the `200` status
  - added the optional property `items/description` to the response with the `200` status
  - added the optional property `items/environment` to the response with the `200` status
  - added the optional property `items/error_detail` to the response with the `200` status
  - added the optional property `items/events` to the response with the `200` status
  - added the optional property `items/id` to the response with the `200` status
  - added the optional property `items/name` to the response with the `200` status
  - added the optional property `items/period` to the response with the `200` status
  - added the optional property `items/product` to the response with the `200` status
  - added the optional property `items/rejection_note` to the response with the `200` status
  - added the optional property `items/schema` to the response with the `200` status
  - added the optional property `items/stats` to the response with the `200` status
  - added the optional property `items/status` to the response with the `200` status
  - added the required property `items/contract` to the response with the `200` status
  - added the required property `items/external_id` to the response with the `200` status
  - added the required property `items/marketplace` to the response with the `200` status
  - added the required property `items/provider` to the response with the `200` status
  - added the required property `items/vendor` to the response with the `200` status
- **2022-06-30** `6118e3620603`: 2 info
  - api operation id `usage_file_list_listUsageFiles` removed and replaced with `usage_usage_file_list_listUsageFiles`
  - added the new optional `query` request parameter `external_id`

---

[Operation](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api/docs/usage/files/get.md) - [API](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api.md) - [Page](https://skmtc.dev/cloudblue/apis/cloudblue-connect-api/changes/usage/files/get)