---
title: "Changes to Get customer usage summary"
method: GET
path: "/customers/usage"
---

# Changes to Get customer usage summary

`GET /customers/usage`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 19 of 139 revisions.

- **2026-09-23** `c2dd8587a719`: 6 info
- **2026-09-22** `9848123298ef`: 1 info
- **2026-09-21** `15dcbc3c880b`: 1 info
- **2026-09-21** `56ac1e6adeb7`: 1 warning
- **2026-09-21** `0aa0bf7c01e1`: 1 info
- **2026-09-21** `c730635dc27e`: 1 warning
- **2026-09-21** `063d4dc9bde2`: 1 info
- **2026-09-20** `c07da7bc72cd`: 1 warning
- **2026-09-20** `a10f1600271a`: 1 info
- **2026-09-03** `e36fe54e0efb`: 1 info
- **2026-07-15** `f8ecf435d25d`: 2 warning
- **2026-07-09** `7d57386313c7`: 8 breaking, 9 warning, 14 info
- **2026-07-09** `4b1a811c4179`: 20 breaking, 14 warning, 9 info
- **2026-06-29** `7857ddc6e44d`: 1 warning, 1 info
- **2026-05-18** `8ec2edea6b20`: 4 warning
- **2026-04-10** `5856ed2fbdd6`: 1 warning
- **2026-04-06** `95af41a12111`: 4 warning, 8 info
- **2026-03-20** `d563556cdaf1`: 3 info
- **2026-03-02** `8ab89ff34fdc`: 1 info

## Changes

- **2026-09-23** `c2dd8587a719`: 6 info
  - added the optional property `features/items/grant_duration_unit` to the response with the `200` status
  - added the optional property `features/items/grant_duration_value` to the response with the `200` status
  - added the optional property `features/items/grant_measure` to the response with the `200` status
  - added the optional property `features/items/grant_quota` to the response with the `200` status
  - added the optional property `features/items/grant_state/allowances/items/quota_crossed_at` to the response with the `200` status
  - added the optional property `features/items/grant_unlimited` to the response with the `200` status
- **2026-09-22** `9848123298ef`: 1 info
  - added the optional property `features/items/buckets` to the response with the `200` status
- **2026-09-21** `15dcbc3c880b`: 1 info
  - added the optional property `features/items/grant_state` to the response with the `200` status
- **2026-09-21** `56ac1e6adeb7`: 1 warning
  - removed the optional property `features/items/grant_state` from the response with the `200` status
- **2026-09-21** `0aa0bf7c01e1`: 1 info
  - added the optional property `features/items/grant_state` to the response with the `200` status
- **2026-09-21** `c730635dc27e`: 1 warning
  - removed the optional property `features/items/grant_state` from the response with the `200` status
- **2026-09-21** `063d4dc9bde2`: 1 info
  - added the optional property `features/items/grant_state` to the response with the `200` status
- **2026-09-20** `c07da7bc72cd`: 1 warning
  - removed the optional property `features/items/grant_state` from the response with the `200` status
- **2026-09-20** `a10f1600271a`: 1 info
  - added the optional property `features/items/grant_state` to the response with the `200` status
- **2026-09-03** `e36fe54e0efb`: 1 info
  - added the optional property `features/items/feature/alert_settings/alert_threshold_type` to the response with the `200` status
- **2026-07-15** `f8ecf435d25d`: 2 warning
  - added the new `not_implemented` enum value to the `code` response property for the response status `400`
  - added the new `not_implemented` enum value to the `code` response property for the response status `500`
- **2026-07-09** `7d57386313c7`: 8 breaking, 9 warning, 14 info
  - the `features/items/feature/metadata` response's property type changed from no type to `object` for status `200`
  - the `features/items/feature/meter/aggregation` response's property type changed from no type to `object` for status `200`
  - the `features/items/feature/meter/filters/items/` response's property type changed from no type to `object` for status `200`
  - the `features/items/feature/meter/reset_usage` response's property type changed from no type to `string` for status `200`
  - the `features/items/feature/reporting_unit` response's property type changed from no type to `object` for status `200`
  - the `features/items/feature/status` response's property type changed from no type to `string` for status `200`
  - the `features/items/feature/type` response's property type changed from no type to `string` for status `200`
  - the `pagination` response's property type changed from no type to `object` for status `200`
  - added the new `BILLING_PERIOD` enum value to the `features/items/feature/meter/reset_usage` response property for the response status `200`
  - added the new `NEVER` enum value to the `features/items/feature/meter/reset_usage` response property for the response status `200`
  - added the new `archived` enum value to the `features/items/feature/status` response property for the response status `200`
  - added the new `boolean` enum value to the `features/items/feature/type` response property for the response status `200`
  - added the new `config` enum value to the `features/items/feature/type` response property for the response status `200`
  - added the new `deleted` enum value to the `features/items/feature/status` response property for the response status `200`
  - added the new `metered` enum value to the `features/items/feature/type` response property for the response status `200`
  - added the new `published` enum value to the `features/items/feature/status` response property for the response status `200`
  - added the new `static` enum value to the `features/items/feature/type` response property for the response status `200`
  - added the optional property `features/items/feature/meter/aggregation/bucket_size` to the response with the `200` status
  - added the optional property `features/items/feature/meter/aggregation/expression` to the response with the `200` status
  - added the optional property `features/items/feature/meter/aggregation/field` to the response with the `200` status
  - added the optional property `features/items/feature/meter/aggregation/group_by` to the response with the `200` status
  - added the optional property `features/items/feature/meter/aggregation/multiplier` to the response with the `200` status
  - added the optional property `features/items/feature/meter/aggregation/type` to the response with the `200` status
  - added the optional property `features/items/feature/meter/filters/items/key` to the response with the `200` status
  - added the optional property `features/items/feature/meter/filters/items/values` to the response with the `200` status
  - added the optional property `features/items/feature/reporting_unit/conversion_rate` to the response with the `200` status
  - added the optional property `features/items/feature/reporting_unit/unit_plural` to the response with the `200` status
  - added the optional property `features/items/feature/reporting_unit/unit_singular` to the response with the `200` status
  - added the optional property `pagination/limit` to the response with the `200` status
  - added the optional property `pagination/offset` to the response with the `200` status
  - added the optional property `pagination/total` to the response with the `200` status
- **2026-07-09** `4b1a811c4179`: 20 breaking, 14 warning, 9 info
  - the `features/items/feature/alert_settings/critical/threshold` response's property type changed from `number` to `string` for status `200`
  - the `features/items/feature/alert_settings/info/threshold` response's property type changed from `number` to `string` for status `200`
  - the `features/items/feature/alert_settings/warning/threshold` response's property type changed from `number` to `string` for status `200`
  - the `features/items/feature/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `features/items/feature/group/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `features/items/feature/group/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `features/items/feature/metadata` response's property type changed from `object` to no type for status `200`
  - the `features/items/feature/meter/aggregation` response's property type changed from `object` to no type for status `200`
  - the `features/items/feature/meter/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `features/items/feature/meter/filters/items/` response's property type changed from `object` to no type for status `200`
  - the `features/items/feature/meter/reset_usage` response's property type changed from `string` to no type for status `200`
  - the `features/items/feature/meter/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `features/items/feature/reporting_unit` response's property type changed from `object` to no type for status `200`
  - the `features/items/feature/status` response's property type changed from `string` to no type for status `200`
  - the `features/items/feature/type` response's property type changed from `string` to no type for status `200`
  - the `features/items/feature/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `features/items/next_usage_reset_at` response's property format changed from `date-time` to no format for status `200`
  - the `pagination` response's property type changed from `object` to no type for status `200`
  - the `period/end_time` response's property format changed from `date-time` to no format for status `200`
  - the `period/start_time` response's property format changed from `date-time` to no format for status `200`
  - removed the optional property `features/items/feature/meter/aggregation/bucket_size` from the response with the `200` status
  - removed the optional property `features/items/feature/meter/aggregation/expression` from the response with the `200` status
  - removed the optional property `features/items/feature/meter/aggregation/field` from the response with the `200` status
  - removed the optional property `features/items/feature/meter/aggregation/group_by` from the response with the `200` status
  - removed the optional property `features/items/feature/meter/aggregation/multiplier` from the response with the `200` status
  - removed the optional property `features/items/feature/meter/aggregation/type` from the response with the `200` status
  - removed the optional property `features/items/feature/meter/filters/items/key` from the response with the `200` status
  - removed the optional property `features/items/feature/meter/filters/items/values` from the response with the `200` status
  - removed the optional property `features/items/feature/reporting_unit/conversion_rate` from the response with the `200` status
  - removed the optional property `features/items/feature/reporting_unit/unit_plural` from the response with the `200` status
  - removed the optional property `features/items/feature/reporting_unit/unit_singular` from the response with the `200` status
  - removed the optional property `pagination/limit` from the response with the `200` status
  - removed the optional property `pagination/offset` from the response with the `200` status
  - removed the optional property `pagination/total` from the response with the `200` status
  - removed the `BILLING_PERIOD` enum value from the `features/items/feature/meter/reset_usage` response property for the response status `200`
  - removed the `NEVER` enum value from the `features/items/feature/meter/reset_usage` response property for the response status `200`
  - removed the `archived` enum value from the `features/items/feature/status` response property for the response status `200`
  - removed the `boolean` enum value from the `features/items/feature/type` response property for the response status `200`
  - removed the `config` enum value from the `features/items/feature/type` response property for the response status `200`
  - removed the `deleted` enum value from the `features/items/feature/status` response property for the response status `200`
  - …3 more
- **2026-06-29** `7857ddc6e44d`: 1 warning, 1 info
  - added the new `config` enum value to the `features/items/feature/type` response property for the response status `200`
  - added the optional property `features/items/sources/items/config_value` to the response with the `200` status
- **2026-05-18** `8ec2edea6b20`: 4 warning
  - removed the optional property `details` from the response with the `400` status
  - removed the optional property `details` from the response with the `500` status
  - added the new `too_many_requests` enum value to the `code` response property for the response status `400`
  - added the new `too_many_requests` enum value to the `code` response property for the response status `500`
- **2026-04-10** `5856ed2fbdd6`: 1 warning
  - added the new `ONETIME` enum value to the `features/items/sources/items/usage_reset_period` response property for the response status `200`
- **2026-04-06** `95af41a12111`: 4 warning, 8 info
  - removed the optional property `error` from the response with the `400` status
  - removed the optional property `error` from the response with the `500` status
  - removed the optional property `success` from the response with the `400` status
  - removed the optional property `success` from the response with the `500` status
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `500` status
  - added the optional property `details` to the response with the `400` status
  - added the optional property `details` to the response with the `500` status
  - added the optional property `http_status_code` to the response with the `400` status
  - added the optional property `http_status_code` to the response with the `500` status
  - added the optional property `message` to the response with the `400` status
  - added the optional property `message` to the response with the `500` status
- **2026-03-20** `d563556cdaf1`: 3 info
  - added the optional property `features/items/feature/group` to the response with the `200` status
  - added the optional property `features/items/feature/group_id` to the response with the `200` status
  - added the optional property `features/items/feature/reporting_unit` to the response with the `200` status
- **2026-03-02** `8ab89ff34fdc`: 1 info
  - added the optional property `features/items/feature/meter/aggregation/expression` to the response with the `200` status

---

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