---
title: "Changes to Get usage analytics"
method: POST
path: "/events/analytics"
---

# Changes to Get usage analytics

`POST /events/analytics`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 32 of 139 revisions.

- **2026-09-19** `ee9cc26d2500`: 1 info
- **2026-09-18** `0fb60b40c570`: 1 warning
- **2026-09-14** `5f9d16cd8235`: 1 info
- **2026-09-03** `e36fe54e0efb`: 1 info
- **2026-09-01** `e1d4e27b5677`: 2 info
- **2026-08-24** `9cd0dab91f5c`: 1 info
- **2026-08-24** `66536658bde6`: 1 info
- **2026-08-21** `d567e8585c2e`: 1 warning
- **2026-08-21** `edf928b9b745`: 1 info
- **2026-07-31** `50b7421a9690`: 1 info
- **2026-07-15** `f8ecf435d25d`: 3 warning, 1 info
- **2026-07-09** `646d6658479b`: 2 breaking, 2 info
- **2026-07-09** `7d57386313c7`: 33 breaking, 48 warning, 109 info
- **2026-07-09** `4b1a811c4179`: 68 breaking, 98 warning, 50 info
- **2026-07-03** `2c73641f19ac`: 3 warning, 3 info
- **2026-06-30** `324e06d26cc8`: 6 info
- **2026-06-29** `7857ddc6e44d`: 1 warning
- **2026-06-16** `257509e66883`: 9 info
- **2026-06-10** `2a40f94de722`: 1 info
- **2026-06-03** `7adf4f33ea1a`: 2 info
- **2026-05-18** `8ec2edea6b20`: 4 warning
- **2026-04-25** `5cfd03c5fc75`: 1 warning
- **2026-04-23** `2ead4d5de7c1`: 3 warning, 3 info
- **2026-04-22** `147c5358b6c7`: 1 info
- **2026-04-21** `a51d090509a7`: 1 warning
- **2026-04-10** `5856ed2fbdd6`: 5 warning, 2 info
- **2026-04-06** `95af41a12111`: 4 warning, 10 info
- **2026-04-04** `daf147b28b31`: 4 info
- **2026-04-04** `9013edc21339`: 2 breaking
- **2026-04-04** `33afc71210f5`: 4 warning
- **2026-03-20** `d563556cdaf1`: 6 info
- **2026-03-02** `8ab89ff34fdc`: 2 info

## Changes

- **2026-09-19** `ee9cc26d2500`: 1 info
  - added the optional property `items/items/external_customer_id` to the response with the `200` status
- **2026-09-18** `0fb60b40c570`: 1 warning
  - removed the optional property `items/items/external_customer_id` from the response with the `200` status
- **2026-09-14** `5f9d16cd8235`: 1 info
  - added the optional property `items/items/external_customer_id` to the response with the `200` status
- **2026-09-03** `e36fe54e0efb`: 1 info
  - added the optional property `items/items/feature/alert_settings/alert_threshold_type` to the response with the `200` status
- **2026-09-01** `e1d4e27b5677`: 2 info
  - added the optional property `items/items/price/bucket_size` to the response with the `200` status
  - added the optional property `items/items/subscription_line_item/price/bucket_size` to the response with the `200` status
- **2026-08-24** `9cd0dab91f5c`: 1 info
  - added the optional property `items/items/price/plan/price_sync_status` to the response with the `200` status
- **2026-08-24** `66536658bde6`: 1 info
  - added the optional property `items/items/price/feature` to the response with the `200` status
- **2026-08-21** `d567e8585c2e`: 1 warning
  - removed the optional property `items/items/price/plan/price_sync_status` from the response with the `200` status
- **2026-08-21** `edf928b9b745`: 1 info
  - added the optional property `items/items/price/plan/price_sync_status` to the response with the `200` status
- **2026-07-31** `50b7421a9690`: 1 info
  - added the optional property `items/items/subscription_line_item/meter` to the response with the `200` status
- **2026-07-15** `f8ecf435d25d`: 3 warning, 1 info
  - added the new `ADDON` enum value to the `items/items/price/plan/credit_grants/items/scope` response property for the response status `200`
  - 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`
  - added the optional property `items/items/price/plan/credit_grants/items/addon_id` to the response with the `200` status
- **2026-07-09** `646d6658479b`: 2 breaking, 2 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`
  - the `billing_period_count` response's property default value `1` was removed for the status `200`
- **2026-07-09** `7d57386313c7`: 33 breaking, 48 warning, 109 info
  - request property `window_size` was restricted to a list of enum values
  - the `window_size` request property type changed from no type to `string`
  - the `items/items/addon/status` response's property type changed from no type to `string` for status `200`
  - the `items/items/feature/group` response's property type changed from no type to `object` for status `200`
  - the `items/items/feature/metadata` response's property type changed from no type to `object` for status `200`
  - the `items/items/feature/reporting_unit` response's property type changed from no type to `object` for status `200`
  - the `items/items/feature/status` response's property type changed from no type to `string` for status `200`
  - the `items/items/feature/type` response's property type changed from no type to `string` for status `200`
  - the `items/items/group` response's property type changed from no type to `object` for status `200`
  - the `items/items/meter` response's property type changed from no type to `object` for status `200`
  - the `items/items/plan/metadata` response's property type changed from no type to `object` for status `200`
  - the `items/items/plan/status` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/entity_type` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/invoice_cadence` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/metadata` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/meter/aggregation` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/meter/filters/items/` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/meter/reset_usage` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/plan/credit_grants/items/metadata` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/plan/credit_grants/items/status` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/plan/metadata` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/plan/status` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/price_unit_tiers/items/` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/price_unit_type` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/pricing_unit/metadata` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/pricing_unit/status` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/status` response's property type changed from no type to `string` for status `200`
  - the `items/items/price/tiers/items/` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/transform_quantity` response's property type changed from no type to `object` for status `200`
  - the `items/items/price/type` response's property type changed from no type to `string` for status `200`
  - the `items/items/reporting_unit` response's property type changed from no type to `object` for status `200`
  - the `items/items/subscription_line_item` response's property type changed from no type to `object` for status `200`
  - the `items/items/window_size` response's property type changed from no type to `string` for status `200`
  - added the new `12HOUR` enum value to the `items/items/window_size` response property for the response status `200`
  - added the new `15MIN` enum value to the `items/items/window_size` response property for the response status `200`
  - added the new `30MIN` enum value to the `items/items/window_size` response property for the response status `200`
  - added the new `3HOUR` enum value to the `items/items/window_size` response property for the response status `200`
  - added the new `6HOUR` enum value to the `items/items/window_size` response property for the response status `200`
  - added the new `ADDON` enum value to the `items/items/price/entity_type` response property for the response status `200`
  - added the new `ADVANCE` enum value to the `items/items/price/invoice_cadence` response property for the response status `200`
  - …150 more
- **2026-07-09** `4b1a811c4179`: 68 breaking, 98 warning, 50 info
  - removed the enum value `12HOUR` of the request property `window_size`
  - removed the enum value `15MIN` of the request property `window_size`
  - removed the enum value `30MIN` of the request property `window_size`
  - removed the enum value `3HOUR` of the request property `window_size`
  - removed the enum value `6HOUR` of the request property `window_size`
  - removed the enum value `DAY` of the request property `window_size`
  - removed the enum value `HOUR` of the request property `window_size`
  - removed the enum value `MINUTE` of the request property `window_size`
  - removed the enum value `MONTH` of the request property `window_size`
  - removed the enum value `WEEK` of the request property `window_size`
  - the `window_size` request property type changed from `string` to no type
  - the `items/items/addon/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/addon/status` response's property type changed from `string` to no type for status `200`
  - the `items/items/addon/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/feature/alert_settings/critical/threshold` response's property type changed from `number` to `string` for status `200`
  - the `items/items/feature/alert_settings/info/threshold` response's property type changed from `number` to `string` for status `200`
  - the `items/items/feature/alert_settings/warning/threshold` response's property type changed from `number` to `string` for status `200`
  - the `items/items/feature/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/feature/group` response's property type changed from `object` to no type for status `200`
  - the `items/items/feature/metadata` response's property type changed from `object` to no type for status `200`
  - the `items/items/feature/reporting_unit` response's property type changed from `object` to no type for status `200`
  - the `items/items/feature/status` response's property type changed from `string` to no type for status `200`
  - the `items/items/feature/type` response's property type changed from `string` to no type for status `200`
  - the `items/items/feature/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/group` response's property type changed from `object` to no type for status `200`
  - the `items/items/meter` response's property type changed from `object` to no type for status `200`
  - the `items/items/plan/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/plan/metadata` response's property type changed from `object` to no type for status `200`
  - the `items/items/plan/status` response's property type changed from `string` to no type for status `200`
  - the `items/items/plan/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/end_date` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/entity_type` response's property type changed from `string` to no type for status `200`
  - the `items/items/price/group/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/group/updated_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/invoice_cadence` response's property type changed from `string` to no type for status `200`
  - the `items/items/price/metadata` response's property type changed from `object` to no type for status `200`
  - the `items/items/price/meter/aggregation` response's property type changed from `object` to no type for status `200`
  - the `items/items/price/meter/created_at` response's property format changed from `date-time` to no format for status `200`
  - the `items/items/price/meter/filters/items/` response's property type changed from `object` to no type for status `200`
  - …176 more
- **2026-07-03** `2c73641f19ac`: 3 warning, 3 info
  - removed the optional property `items/items/net_cost` from the response with the `200` status
  - removed the optional property `items/items/points/items/net_cost` from the response with the `200` status
  - removed the optional property `total_net_cost` from the response with the `200` status
  - added the optional property `items/items/points/items/subtotal` to the response with the `200` status
  - added the optional property `items/items/subtotal` to the response with the `200` status
  - added the optional property `subtotal` to the response with the `200` status
- **2026-06-30** `324e06d26cc8`: 6 info
  - added the optional property `items/items/net_cost` to the response with the `200` status
  - added the optional property `items/items/points/items/discount` to the response with the `200` status
  - added the optional property `items/items/points/items/net_cost` to the response with the `200` status
  - added the optional property `items/items/total_discount` to the response with the `200` status
  - added the optional property `total_discount` to the response with the `200` status
  - added the optional property `total_net_cost` to the response with the `200` status
- **2026-06-29** `7857ddc6e44d`: 1 warning
  - added the new `config` enum value to the `items/items/feature/type` response property for the response status `200`
- **2026-06-16** `257509e66883`: 9 info
  - added the new optional request property `breakdown_bucket`
  - added the optional property `items/items/bucket_summaries` to the response with the `200` status
  - added the optional property `items/items/points/items/buckets` to the response with the `200` status
  - added the optional property `items/items/subscription_line_item/commitment_time_buckets/items/commitment_type` to the response with the `200` status
  - added the optional property `items/items/subscription_line_item/commitment_time_buckets/items/commitment_value` to the response with the `200` status
  - added the optional property `items/items/subscription_line_item/commitment_time_buckets/items/id` to the response with the `200` status
  - added the optional property `items/items/subscription_line_item/commitment_time_buckets/items/overage_factor` to the response with the `200` status
  - added the optional property `items/items/subscription_line_item/commitment_time_buckets/items/price_id` to the response with the `200` status
  - added the optional property `items/items/subscription_line_item/commitment_time_buckets/items/true_up_enabled` to the response with the `200` status
- **2026-06-10** `2a40f94de722`: 1 info
  - added the optional property `items/items/subscription_line_item/commitment_time_buckets` to the response with the `200` status
- **2026-06-03** `7adf4f33ea1a`: 2 info
  - added the optional property `items/items/price/sequence` to the response with the `200` status
  - added the optional property `items/items/subscription_line_item/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-25** `5cfd03c5fc75`: 1 warning
  - removed the optional property `items/items/subscription_line_item/trial_period_days` from the response with the `200` status
- **2026-04-23** `2ead4d5de7c1`: 3 warning, 3 info
  - removed the optional property `items/items/price/trial_period` from the response with the `200` status
  - removed the optional property `items/items/subscription_line_item/price/trial_period` from the response with the `200` status
  - removed the optional property `items/items/subscription_line_item/trial_period` from the response with the `200` status
  - added the optional property `items/items/price/trial_period_days` to the response with the `200` status
  - added the optional property `items/items/subscription_line_item/price/trial_period_days` to the response with the `200` status
  - added the optional property `items/items/subscription_line_item/trial_period_days` to the response with the `200` status
- **2026-04-22** `147c5358b6c7`: 1 info
  - added the optional property `items/items/subscription_line_item/addon_association_id` to the response with the `200` status
- **2026-04-21** `a51d090509a7`: 1 warning
  - removed the optional property `items/items/addon/type` from the response with the `200` status
- **2026-04-10** `5856ed2fbdd6`: 5 warning, 2 info
  - added the new `ONETIME` enum value to the `items/items/commitment_info/duration` response property for the response status `200`
  - added the new `ONETIME` enum value to the `items/items/price/billing_period` response property for the response status `200`
  - added the new `ONETIME` enum value to the `items/items/subscription_line_item/billing_period` response property for the response status `200`
  - added the new `ONETIME` enum value to the `items/items/subscription_line_item/commitment_duration` response property for the response status `200`
  - added the new `ONETIME` enum value to the `items/items/subscription_line_item/price/billing_period` response property for the response status `200`
  - removed the `ONETIME` enum value from the `items/items/price/billing_cadence` response property for the response status `200`
  - removed the `ONETIME` enum value from the `items/items/subscription_line_item/price/billing_cadence` response property for the response status `200`
- **2026-04-06** `95af41a12111`: 4 warning, 10 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 new optional request property `include_children`
  - the request property `external_customer_id` became optional
  - 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** `daf147b28b31`: 4 info
  - added the optional property `items/items/addon` to the response with the `200` status
  - added the optional property `items/items/feature` to the response with the `200` status
  - added the optional property `items/items/plan` to the response with the `200` status
  - added the optional property `items/items/subscription_line_item` to the response with the `200` 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-04-04** `33afc71210f5`: 4 warning
  - removed the optional property `items/items/addon` from the response with the `200` status
  - removed the optional property `items/items/feature` from the response with the `200` status
  - removed the optional property `items/items/plan` from the response with the `200` status
  - removed the optional property `items/items/subscription_line_item` from the response with the `200` status
- **2026-03-20** `d563556cdaf1`: 6 info
  - added the optional property `items/items/feature/group` to the response with the `200` status
  - added the optional property `items/items/feature/group_id` to the response with the `200` status
  - added the optional property `items/items/feature/reporting_unit` to the response with the `200` status
  - added the optional property `items/items/group` to the response with the `200` status
  - added the optional property `items/items/reporting_unit` to the response with the `200` status
  - added the optional property `items/items/total_usage_display` to the response with the `200` status
- **2026-03-02** `8ab89ff34fdc`: 2 info
  - added the optional property `items/items/meter/aggregation/expression` to the response with the `200` status
  - added the optional property `items/items/price/meter/aggregation/expression` to the response with the `200` status

---

[Operation](https://skmtc.dev/flexprice/apis/flexprice-api/docs/events/analytics/post.md) - [API](https://skmtc.dev/flexprice/apis/flexprice-api.md) - [Page](https://skmtc.dev/flexprice/apis/flexprice-api/changes/events/analytics/post)
