--- title: "Changes to Get usage by subscription" method: POST path: "/subscriptions/usage" --- # Changes to Get usage by subscription `POST /subscriptions/usage` > Every recorded change to this operation, newest first. ## Timeline Changed in 12 of 139 revisions. - **2026-09-01** `e1d4e27b5677`: 1 info - **2026-07-15** `f8ecf435d25d`: 2 warning - **2026-07-09** `646d6658479b`: 2 breaking, 1 info - **2026-07-09** `7d57386313c7`: 2 breaking, 41 info - **2026-07-09** `4b1a811c4179`: 4 breaking, 41 warning, 2 info - **2026-06-03** `7adf4f33ea1a`: 1 info - **2026-05-18** `8ec2edea6b20`: 4 warning - **2026-04-23** `2ead4d5de7c1`: 1 warning, 1 info - **2026-04-10** `5856ed2fbdd6`: 1 warning, 1 info - **2026-04-06** `95af41a12111`: 4 warning, 8 info - **2026-04-04** `9013edc21339`: 2 breaking - **2026-03-02** `8ab89ff34fdc`: 1 info ## Changes - **2026-09-01** `e1d4e27b5677`: 1 info - added the optional property `charges/items/price/bucket_size` 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** `646d6658479b`: 2 breaking, 1 info - the `end_time` request property format changed from no format to `date-time` - the `start_time` request property format changed from no format to `date-time` - the `billing_period_count` response's property default value `1` was removed for the status `200` - **2026-07-09** `7d57386313c7`: 2 breaking, 41 info - the `charges/items/filter_values` response's property type changed from no type to `object` for status `200` - the `charges/items/price` response's property type changed from no type to `object` for status `200` - added the optional property `charges/items/price/amount` to the response with the `200` status - added the optional property `charges/items/price/billing_cadence` to the response with the `200` status - added the optional property `charges/items/price/billing_model` to the response with the `200` status - added the optional property `charges/items/price/billing_period` to the response with the `200` status - added the optional property `charges/items/price/billing_period_count` to the response with the `200` status - added the optional property `charges/items/price/conversion_rate` to the response with the `200` status - added the optional property `charges/items/price/created_at` to the response with the `200` status - added the optional property `charges/items/price/created_by` to the response with the `200` status - added the optional property `charges/items/price/currency` to the response with the `200` status - added the optional property `charges/items/price/description` to the response with the `200` status - added the optional property `charges/items/price/display_amount` to the response with the `200` status - added the optional property `charges/items/price/display_name` to the response with the `200` status - added the optional property `charges/items/price/display_price_unit_amount` to the response with the `200` status - added the optional property `charges/items/price/end_date` to the response with the `200` status - added the optional property `charges/items/price/entity_id` to the response with the `200` status - added the optional property `charges/items/price/entity_type` to the response with the `200` status - added the optional property `charges/items/price/environment_id` to the response with the `200` status - added the optional property `charges/items/price/group_id` to the response with the `200` status - added the optional property `charges/items/price/id` to the response with the `200` status - added the optional property `charges/items/price/invoice_cadence` to the response with the `200` status - added the optional property `charges/items/price/lookup_key` to the response with the `200` status - added the optional property `charges/items/price/metadata` to the response with the `200` status - added the optional property `charges/items/price/meter_id` to the response with the `200` status - added the optional property `charges/items/price/min_quantity` to the response with the `200` status - added the optional property `charges/items/price/parent_price_id` to the response with the `200` status - added the optional property `charges/items/price/price_unit` to the response with the `200` status - added the optional property `charges/items/price/price_unit_amount` to the response with the `200` status - added the optional property `charges/items/price/price_unit_id` to the response with the `200` status - added the optional property `charges/items/price/price_unit_tiers` to the response with the `200` status - added the optional property `charges/items/price/price_unit_type` to the response with the `200` status - added the optional property `charges/items/price/sequence` to the response with the `200` status - added the optional property `charges/items/price/start_date` to the response with the `200` status - added the optional property `charges/items/price/status` to the response with the `200` status - added the optional property `charges/items/price/tenant_id` to the response with the `200` status - added the optional property `charges/items/price/tier_mode` to the response with the `200` status - added the optional property `charges/items/price/tiers` to the response with the `200` status - added the optional property `charges/items/price/transform_quantity` to the response with the `200` status - added the optional property `charges/items/price/trial_period_days` to the response with the `200` status - …3 more - **2026-07-09** `4b1a811c4179`: 4 breaking, 41 warning, 2 info - the `charges/items/filter_values` response's property type changed from `object` to no type for status `200` - the `charges/items/price` response's property type changed from `object` to no type for status `200` - the `end_time` response's property format changed from `date-time` to no format for status `200` - the `start_time` response's property format changed from `date-time` to no format for status `200` - removed the optional property `charges/items/price/amount` from the response with the `200` status - removed the optional property `charges/items/price/billing_cadence` from the response with the `200` status - removed the optional property `charges/items/price/billing_model` from the response with the `200` status - removed the optional property `charges/items/price/billing_period` from the response with the `200` status - removed the optional property `charges/items/price/billing_period_count` from the response with the `200` status - removed the optional property `charges/items/price/conversion_rate` from the response with the `200` status - removed the optional property `charges/items/price/created_at` from the response with the `200` status - removed the optional property `charges/items/price/created_by` from the response with the `200` status - removed the optional property `charges/items/price/currency` from the response with the `200` status - removed the optional property `charges/items/price/description` from the response with the `200` status - removed the optional property `charges/items/price/display_amount` from the response with the `200` status - removed the optional property `charges/items/price/display_name` from the response with the `200` status - removed the optional property `charges/items/price/display_price_unit_amount` from the response with the `200` status - removed the optional property `charges/items/price/end_date` from the response with the `200` status - removed the optional property `charges/items/price/entity_id` from the response with the `200` status - removed the optional property `charges/items/price/entity_type` from the response with the `200` status - removed the optional property `charges/items/price/environment_id` from the response with the `200` status - removed the optional property `charges/items/price/group_id` from the response with the `200` status - removed the optional property `charges/items/price/id` from the response with the `200` status - removed the optional property `charges/items/price/invoice_cadence` from the response with the `200` status - removed the optional property `charges/items/price/lookup_key` from the response with the `200` status - removed the optional property `charges/items/price/metadata` from the response with the `200` status - removed the optional property `charges/items/price/meter_id` from the response with the `200` status - removed the optional property `charges/items/price/min_quantity` from the response with the `200` status - removed the optional property `charges/items/price/parent_price_id` from the response with the `200` status - removed the optional property `charges/items/price/price_unit` from the response with the `200` status - removed the optional property `charges/items/price/price_unit_amount` from the response with the `200` status - removed the optional property `charges/items/price/price_unit_id` from the response with the `200` status - removed the optional property `charges/items/price/price_unit_tiers` from the response with the `200` status - removed the optional property `charges/items/price/price_unit_type` from the response with the `200` status - removed the optional property `charges/items/price/sequence` from the response with the `200` status - removed the optional property `charges/items/price/start_date` from the response with the `200` status - removed the optional property `charges/items/price/status` from the response with the `200` status - removed the optional property `charges/items/price/tenant_id` from the response with the `200` status - removed the optional property `charges/items/price/tier_mode` from the response with the `200` status - removed the optional property `charges/items/price/tiers` from the response with the `200` status - …7 more - **2026-06-03** `7adf4f33ea1a`: 1 info - added the optional property `charges/items/price/sequence` 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-23** `2ead4d5de7c1`: 1 warning, 1 info - removed the optional property `charges/items/price/trial_period` from the response with the `200` status - added the optional property `charges/items/price/trial_period_days` to the response with the `200` status - **2026-04-10** `5856ed2fbdd6`: 1 warning, 1 info - added the new `ONETIME` enum value to the `charges/items/price/billing_period` response property for the response status `200` - removed the `ONETIME` enum value from the `charges/items/price/billing_cadence` 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-04-04** `9013edc21339`: 2 breaking - the `end_time` request property format changed from no format to `date-time` - the `start_time` request property format changed from no format to `date-time` - **2026-03-02** `8ab89ff34fdc`: 1 info - added the optional property `charges/items/subscription_line_item_id` to the response with the `200` status --- [Operation](https://skmtc.dev/flexprice/apis/flexprice-api/docs/subscriptions/usage/post.md) - [API](https://skmtc.dev/flexprice/apis/flexprice-api.md) - [Page](https://skmtc.dev/flexprice/apis/flexprice-api/changes/subscriptions/usage/post)