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

# Changes to GET /usage/records

`GET /usage/records`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 12 revisions.

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

## Changes

- **2025-05-17** `2de715cbd1f3`: 1 breaking, 26 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/amount` to the response with the `200` status
  - added the optional property `items/asset` to the response with the `200` status
  - added the optional property `items/asset_external_id` to the response with the `200` status
  - added the optional property `items/asset_external_uid` to the response with the `200` status
  - added the optional property `items/asset_id` to the response with the `200` status
  - added the optional property `items/category` to the response with the `200` status
  - added the optional property `items/closed_at` to the response with the `200` status
  - added the optional property `items/closed_by` to the response with the `200` status
  - added the optional property `items/end_date` to the response with the `200` status
  - added the optional property `items/external_billing_id` to the response with the `200` status
  - added the optional property `items/external_billing_note` 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/item` to the response with the `200` status
  - added the optional property `items/item_id` to the response with the `200` status
  - added the optional property `items/multiplier` to the response with the `200` status
  - added the optional property `items/params` to the response with the `200` status
  - added the optional property `items/product_id` to the response with the `200` status
  - added the optional property `items/resource_local_id` to the response with the `200` status
  - added the optional property `items/start_date` to the response with the `200` status
  - added the optional property `items/status` to the response with the `200` status
  - added the optional property `items/tier` to the response with the `200` status
  - added the required property `items/usage` to the response with the `200` status
  - added the required property `items/usagefile` to the response with the `200` status
- **2023-12-01** `22a697bcb678`: 4 breaking, 23 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/usage` from the response with the `200` status
  - removed the required property `items/usagefile` from the response with the `200` status
  - deleted the `query` request parameter `limit`
  - deleted the `query` request parameter `offset`
  - removed the optional property `items/amount` from the response with the `200` status
  - removed the optional property `items/asset` from the response with the `200` status
  - removed the optional property `items/asset_external_id` from the response with the `200` status
  - removed the optional property `items/asset_external_uid` from the response with the `200` status
  - removed the optional property `items/asset_id` from the response with the `200` status
  - removed the optional property `items/category` from the response with the `200` status
  - removed the optional property `items/closed_at` from the response with the `200` status
  - removed the optional property `items/closed_by` from the response with the `200` status
  - removed the optional property `items/end_date` from the response with the `200` status
  - removed the optional property `items/external_billing_id` from the response with the `200` status
  - removed the optional property `items/external_billing_note` 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/item` from the response with the `200` status
  - removed the optional property `items/item_id` from the response with the `200` status
  - removed the optional property `items/multiplier` from the response with the `200` status
  - removed the optional property `items/params` from the response with the `200` status
  - removed the optional property `items/product_id` from the response with the `200` status
  - removed the optional property `items/resource_local_id` from the response with the `200` status
  - removed the optional property `items/start_date` from the response with the `200` status
  - removed the optional property `items/status` from the response with the `200` status
  - removed the optional property `items/tier` from the response with the `200` status
- **2022-12-08** `86adefb0bb29`: 1 breaking, 26 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/amount` to the response with the `200` status
  - added the optional property `items/asset` to the response with the `200` status
  - added the optional property `items/asset_external_id` to the response with the `200` status
  - added the optional property `items/asset_external_uid` to the response with the `200` status
  - added the optional property `items/asset_id` to the response with the `200` status
  - added the optional property `items/category` to the response with the `200` status
  - added the optional property `items/closed_at` to the response with the `200` status
  - added the optional property `items/closed_by` to the response with the `200` status
  - added the optional property `items/end_date` to the response with the `200` status
  - added the optional property `items/external_billing_id` to the response with the `200` status
  - added the optional property `items/external_billing_note` 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/item` to the response with the `200` status
  - added the optional property `items/item_id` to the response with the `200` status
  - added the optional property `items/multiplier` to the response with the `200` status
  - added the optional property `items/params` to the response with the `200` status
  - added the optional property `items/product_id` to the response with the `200` status
  - added the optional property `items/resource_local_id` to the response with the `200` status
  - added the optional property `items/start_date` to the response with the `200` status
  - added the optional property `items/status` to the response with the `200` status
  - added the optional property `items/tier` to the response with the `200` status
  - added the required property `items/usage` to the response with the `200` status
  - added the required property `items/usagefile` to the response with the `200` status
- **2022-06-30** `6118e3620603`: 1 info
  - api operation id `usage_records_list_listUsageRecords` removed and replaced with `usage_usage_records_list_listUsageRecords`

---

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