--- title: "Changes to List plans" method: GET path: "/api/v1/plans" --- # Changes to List plans `GET /api/v1/plans` > Every recorded change to this operation, newest first. ## Timeline Changed in 21 of 54 revisions. - **2026-08-12** (v1) `4e013b4e4a8f`: 8 breaking - **2026-06-01** (v1) `07a61fe347a5`: 1 breaking, 1 warning - **2026-05-28** (v1) `ed86d893d43e`: 1 breaking, 2 info - **2026-05-18** (v1) `0cdc37620ffb`: 1 info - **2026-03-31** (v1) `ee465c53a423`: 2 info - **2026-03-30** (v1) `5cb340234766`: 1 info - **2026-03-27** (v1) `de35c02bb0d2`: 2 warning, 2 info - **2026-03-20** (v1) `51c7018cc5ef`: 10 info - **2026-02-19** (v1) `1bbd84c95e41`: 2 breaking, 2 info - **2026-01-29** (v1) `6b81fb70c390`: 1 breaking, 6 info - **2026-01-21** (v1) `9fba45d198be`: 2 info - **2026-01-20** (v1) `665f680338b5`: 2 info - **2025-12-17** (v1) `2244ec0dabe3`: 3 breaking, 4 info - **2025-10-20** (v1) `aa51557e5c0b`: 1 breaking, 1 info - **2025-10-17** (v1) `b03a38c9dbd4`: 1 breaking, 1 warning, 1 info - **2025-10-14** (v1) `da72c03d9734`: 1 breaking - **2025-10-13** (v1) `167a049d244e`: 3 breaking, 3 warning, 2 info - **2025-10-13** (v1) `70c1f38948d6`: 3 breaking, 1 warning, 8 info - **2025-07-23** (v1) `cad632d024ce`: 7 warning, 7 info - **2025-07-13** (v1) `95e4503a32c3`: 2 info - **2025-07-09** (v1) `dece17f86f99`: 13 breaking, 17 warning, 19 info ## Changes - **2026-08-12** (v1) `4e013b4e4a8f`: 8 breaking - the response property `data/items/price_components/items/fee/oneOf[#/components/schemas/Fee]/oneOf[#/components/schemas/UsagePlanFee]/pricing/oneOf[#/components/schemas/TieredPlanPricing]/tiers/items/flat_cap` became nullable for the status `200` - the response property `data/items/price_components/items/fee/oneOf[#/components/schemas/Fee]/oneOf[#/components/schemas/UsagePlanFee]/pricing/oneOf[#/components/schemas/TieredPlanPricing]/tiers/items/flat_fee` became nullable for the status `200` - the response property `data/items/price_components/items/fee/oneOf[#/components/schemas/Fee]/oneOf[#/components/schemas/UsagePlanFee]/pricing/oneOf[#/components/schemas/VolumePlanPricing]/tiers/items/flat_cap` became nullable for the status `200` - the response property `data/items/price_components/items/fee/oneOf[#/components/schemas/Fee]/oneOf[#/components/schemas/UsagePlanFee]/pricing/oneOf[#/components/schemas/VolumePlanPricing]/tiers/items/flat_fee` became nullable for the status `200` - the response property `data/items/price_components/items/fee/oneOf[#/components/schemas/Fee]/oneOf[#/components/schemas/UsagePlanFee]/pricing/oneOf[#/components/schemas/TieredPlanPricing]/tiers/items/flat_cap` became optional for the status `200` - the response property `data/items/price_components/items/fee/oneOf[#/components/schemas/Fee]/oneOf[#/components/schemas/UsagePlanFee]/pricing/oneOf[#/components/schemas/TieredPlanPricing]/tiers/items/flat_fee` became optional for the status `200` - the response property `data/items/price_components/items/fee/oneOf[#/components/schemas/Fee]/oneOf[#/components/schemas/UsagePlanFee]/pricing/oneOf[#/components/schemas/VolumePlanPricing]/tiers/items/flat_cap` became optional for the status `200` - the response property `data/items/price_components/items/fee/oneOf[#/components/schemas/Fee]/oneOf[#/components/schemas/UsagePlanFee]/pricing/oneOf[#/components/schemas/VolumePlanPricing]/tiers/items/flat_fee` became optional for the status `200` - **2026-06-01** (v1) `07a61fe347a5`: 1 breaking, 1 warning - removed the required property `data/items/entitlements/items/value/oneOf[#/components/schemas/MeteredEntitlementValue]/overage_behavior` from the response with the `200` status - removed the optional property `data/items/entitlements/items/value/oneOf[#/components/schemas/MeteredEntitlementValue]/warning_threshold_pct` from the response with the `200` status - **2026-05-28** (v1) `ed86d893d43e`: 1 breaking, 2 info - added `#/components/schemas/BooleanEntitlementValue, #/components/schemas/MeteredEntitlementValue` to the `data/items/entitlements/items/value` response property `oneOf` list for the response status `200` - added discriminator to `data/items/entitlements/items/value` response property for the response status `200` - removed `subschema #1, subschema #2` from the `data/items/entitlements/items/value` response property `oneOf` list for the response status `200` - **2026-05-18** (v1) `0cdc37620ffb`: 1 info - added the optional property `data/items/entitlements` to the response with the `200` status - **2026-03-31** (v1) `ee465c53a423`: 2 info - response discriminator property name changed for `data/items/price_components/items/fee/oneOf[#/components/schemas/Fee]/` response property from `fee_type` to `type` for the response status `200` - response discriminator property name changed for `data/items/price_components/items/fee/oneOf[#/components/schemas/Fee]/oneOf[#/components/schemas/UsagePlanFee]/pricing` response property from `discriminator` to `type` for the response status `200` - **2026-03-30** (v1) `5cb340234766`: 1 info - added the new optional `query` request parameter `order_by` - **2026-03-27** (v1) `de35c02bb0d2`: 2 warning, 2 info - deleted the `query` request parameter `type` - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `401` - added the new optional `query` request parameter `plan_type` - added the non-success response with the status `429` - **2026-03-20** (v1) `51c7018cc5ef`: 10 info - added the new optional `query` request parameter `search` - added the new optional `query` request parameter `status` - added the new optional `query` request parameter `type` - added the media type `application/json` for the response with the status `401` - removed the non-success response with the status `500` - added the optional property `data/items/billing_cycles` to the response with the `200` status - added the optional property `data/items/period_start_day` to the response with the `200` status - added the optional property `data/items/self_service_rank` to the response with the `200` status - added `CAPACITY, EXTRA_RECURRING, ONE_TIME, RATE, SLOT, USAGE` discriminator mapping keys to the `data/items/price_components/items/fee/oneOf[#/components/schemas/Fee]/` response property for the response status `200` - removed `capacity, extra_recurring, one_time, rate, slot, usage` discriminator mapping keys from the `data/items/price_components/items/fee/oneOf[#/components/schemas/Fee]/` response property for the response status `200` - **2026-02-19** (v1) `1bbd84c95e41`: 2 breaking, 2 info - the response property `data/items/price_components/items/fee` became optional for the status `200` - added `#/components/schemas/Fee, subschema #1` to the `data/items/price_components/items/fee` response property `oneOf` list for the response status `200` - removed discriminator from `data/items/price_components/items/fee` response property for the response status `200` - removed `#/components/schemas/RatePlanFee, #/components/schemas/SlotPlanFee, #/components/schemas/CapacityPlanFee, #/components/schemas/UsagePlanFee, #/components/schemas/ExtraRecurringPlanFee, #/components/schemas/OneTimePlanFee` from the `data/items/price_components/items/fee` response property `oneOf` list for the response status `200` - **2026-01-29** (v1) `6b81fb70c390`: 1 breaking, 6 info - added `#/components/schemas/PerUnitPlanPricing, #/components/schemas/TieredPlanPricing, #/components/schemas/VolumePlanPricing, #/components/schemas/PackagePlanPricing, #/components/schemas/MatrixPlanPricing` to the `data/items/price_components/items/fee/oneOf[#/components/schemas/UsagePlanFee]/pricing` response property `oneOf` list for the response status `200` - mapped value for discriminator key `MATRIX` changed from `#/components/schemas/MatrixPricing` to `#/components/schemas/MatrixPlanPricing` for `data/items/price_components/items/fee/oneOf[#/components/schemas/UsagePlanFee]/pricing` response property for the response status `200` - mapped value for discriminator key `PACKAGE` changed from `#/components/schemas/PackagePricing` to `#/components/schemas/PackagePlanPricing` for `data/items/price_components/items/fee/oneOf[#/components/schemas/UsagePlanFee]/pricing` response property for the response status `200` - mapped value for discriminator key `PER_UNIT` changed from `#/components/schemas/PerUnitPricing` to `#/components/schemas/PerUnitPlanPricing` for `data/items/price_components/items/fee/oneOf[#/components/schemas/UsagePlanFee]/pricing` response property for the response status `200` - mapped value for discriminator key `TIERED` changed from `#/components/schemas/TieredPricing` to `#/components/schemas/TieredPlanPricing` for `data/items/price_components/items/fee/oneOf[#/components/schemas/UsagePlanFee]/pricing` response property for the response status `200` - mapped value for discriminator key `VOLUME` changed from `#/components/schemas/VolumePricing` to `#/components/schemas/VolumePlanPricing` for `data/items/price_components/items/fee/oneOf[#/components/schemas/UsagePlanFee]/pricing` response property for the response status `200` - removed `#/components/schemas/PerUnitPricing, #/components/schemas/TieredPricing, #/components/schemas/VolumePricing, #/components/schemas/PackagePricing, #/components/schemas/MatrixPricing` from the `data/items/price_components/items/fee/oneOf[#/components/schemas/UsagePlanFee]/pricing` response property `oneOf` list for the response status `200` - **2026-01-21** (v1) `9fba45d198be`: 2 info - api tag `Plans` added - api tag `Plan` removed - **2026-01-20** (v1) `665f680338b5`: 2 info - api tag `Plan` added - api tag `plan` removed - **2025-12-17** (v1) `2244ec0dabe3`: 3 breaking, 4 info - for the `query` request parameter `page`, the format changed from no format to `int32` - for the `query` request parameter `per_page`, the format changed from no format to `int32` - added `#/components/schemas/RatePlanFee, #/components/schemas/SlotPlanFee, #/components/schemas/CapacityPlanFee, #/components/schemas/UsagePlanFee, #/components/schemas/ExtraRecurringPlanFee, #/components/schemas/OneTimePlanFee` to the `data/items/price_components/items/fee` response property `oneOf` list for the response status `200` - the `query` request parameter `page` became optional - the `query` request parameter `per_page` became optional - added discriminator to `data/items/price_components/items/fee` response property for the response status `200` - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` from the `data/items/price_components/items/fee` response property `oneOf` list for the response status `200` - **2025-10-20** (v1) `aa51557e5c0b`: 1 breaking, 1 info - added `subschema #3, subschema #4` to the `data/items/price_components/items/fee` response property `oneOf` list for the response status `200` - removed `subschema #3, subschema #4` from the `data/items/price_components/items/fee` response property `oneOf` list for the response status `200` - **2025-10-17** (v1) `b03a38c9dbd4`: 1 breaking, 1 warning, 1 info - added `subschema #1, subschema #2, subschema #5` to the `data/items/price_components/items/fee` response property `oneOf` list for the response status `200` - added the new `SEMIANNUAL` enum value to the `data/items/available_parameters/billing_periods/additionalProperties/items/` response property for the response status `200` - removed `subschema #1, subschema #2, subschema #5` from the `data/items/price_components/items/fee` response property `oneOf` list for the response status `200` - **2025-10-14** (v1) `da72c03d9734`: 1 breaking - for the `query` request parameter `product_family_id`, the format changed from no format to `MeteroidId` - **2025-10-13** (v1) `167a049d244e`: 3 breaking, 3 warning, 2 info - added the new required `query` request parameter `page` - added the new required `query` request parameter `per_page` - removed the required property `total` from the response with the `200` status - deleted the `query` request parameter `limit` - deleted the `query` request parameter `offset` - deleted the `query` request parameter `search` - the `query` request parameter `product_family_id` became optional - added the required property `pagination_meta` to the response with the `200` status - **2025-10-13** (v1) `70c1f38948d6`: 3 breaking, 1 warning, 8 info - removed the required property `data/items/has_draft_version` from the response with the `200` status - removed the required property `data/items/product_family_id` from the response with the `200` status - removed the required property `data/items/product_family_name` from the response with the `200` status - removed the optional property `data/items/subscription_count` from the response with the `200` status - added the optional property `data/items/trial` to the response with the `200` status - added the required property `data/items/available_parameters` to the response with the `200` status - added the required property `data/items/currency` to the response with the `200` status - added the required property `data/items/net_terms` to the response with the `200` status - added the required property `data/items/price_components` to the response with the `200` status - added the required property `data/items/product_family` to the response with the `200` status - added the required property `data/items/version` to the response with the `200` status - added the required property `data/items/version_id` to the response with the `200` status - **2025-07-23** (v1) `cad632d024ce`: 7 warning, 7 info - added the new `ACTIVE` enum value to the `data/items/status` response property for the response status `200` - added the new `ARCHIVED` enum value to the `data/items/status` response property for the response status `200` - added the new `CUSTOM` enum value to the `data/items/plan_type` response property for the response status `200` - added the new `DRAFT` enum value to the `data/items/status` response property for the response status `200` - added the new `FREE` enum value to the `data/items/plan_type` response property for the response status `200` - added the new `INACTIVE` enum value to the `data/items/status` response property for the response status `200` - added the new `STANDARD` enum value to the `data/items/plan_type` response property for the response status `200` - removed the `active` enum value from the `data/items/status` response property for the response status `200` - removed the `archived` enum value from the `data/items/status` response property for the response status `200` - removed the `custom` enum value from the `data/items/plan_type` response property for the response status `200` - removed the `draft` enum value from the `data/items/status` response property for the response status `200` - removed the `free` enum value from the `data/items/plan_type` response property for the response status `200` - removed the `inactive` enum value from the `data/items/status` response property for the response status `200` - removed the `standard` enum value from the `data/items/plan_type` response property for the response status `200` - **2025-07-13** (v1) `95e4503a32c3`: 2 info - the endpoint scheme security `bearer_auth` was added to the API - the endpoint scheme security `api-key` was removed from the API - **2025-07-09** (v1) `dece17f86f99`: 13 breaking, 17 warning, 19 info - added the new required `query` request parameter `limit` - added the new required `query` request parameter `offset` - the `query` request parameter `product_family_id` became required - the `query` request parameter `search` became required - removed the media type `application/json` for the response with the status `401` - removed the required property `data/items/available_parameters` from the response with the `200` status - removed the required property `data/items/currency` from the response with the `200` status - removed the required property `data/items/net_terms` from the response with the `200` status - removed the required property `data/items/price_components` from the response with the `200` status - removed the required property `data/items/product_family` from the response with the `200` status - removed the required property `data/items/version` from the response with the `200` status - removed the required property `data/items/version_id` from the response with the `200` status - removed the required property `pagination_meta` from the response with the `200` status - deleted the `query` request parameter `order_by` - deleted the `query` request parameter `page` - deleted the `query` request parameter `per_page` - deleted the `query` request parameter `plan_type` - deleted the `query` request parameter `status` - removed the optional property `data/items/billing_cycles` from the response with the `200` status - removed the optional property `data/items/entitlements` from the response with the `200` status - removed the optional property `data/items/period_start_day` from the response with the `200` status - removed the optional property `data/items/self_service_rank` from the response with the `200` status - removed the optional property `data/items/trial` from the response with the `200` status - added the new `active` enum value to the `data/items/status` response property for the response status `200` - added the new `archived` enum value to the `data/items/status` response property for the response status `200` - added the new `custom` enum value to the `data/items/plan_type` response property for the response status `200` - added the new `draft` enum value to the `data/items/status` response property for the response status `200` - added the new `free` enum value to the `data/items/plan_type` response property for the response status `200` - added the new `inactive` enum value to the `data/items/status` response property for the response status `200` - added the new `standard` enum value to the `data/items/plan_type` response property for the response status `200` - the endpoint scheme security `api-key` was added to the API - the endpoint scheme security `bearer_auth` was removed from the API - api tag `plan` added - api tag `Plans` removed - for the `query` request parameter `product_family_id`, the format was generalized from `MeteroidId` to no format - added the non-success response with the status `500` - removed the non-success response with the status `429` - added the optional property `data/items/subscription_count` to the response with the `200` status - removed the `ACTIVE` enum value from the `data/items/status` response property for the response status `200` - removed the `ARCHIVED` enum value from the `data/items/status` response property for the response status `200` - …9 more --- [Operation](https://skmtc.dev/meteroid-oss/apis/meteroid/docs/api/v1/plans/get.md) - [API](https://skmtc.dev/meteroid-oss/apis/meteroid.md) - [Page](https://skmtc.dev/meteroid-oss/apis/meteroid/changes/api/v1/plans/get)