--- title: "Changes to List plans" method: GET path: "/plans" --- # Changes to List plans `GET /plans` > Every recorded change to this operation, newest first. > 230 revisions in range; 1 not diffed. ## Timeline Changed in 30 of 230 revisions. - **2026-10-20** `c7dea159ac06`: 3 info - **2026-10-19** `92f237cd6201`: 1 info - **2026-10-15** `cdb3124e1bed`: 2 breaking, 1 info - **2026-10-06** `8eb4adb2bade`: 4 info - **2026-09-17** `fe6c40d79596`: 6 info - **2026-09-17** `d2fb8bb90eaf`: 3 info - **2026-09-16** `d6b7758ad3d1`: 2 warning - **2026-09-16** `6cf39110fd8f`: 2 info - **2026-09-15** `5a677fa71c74`: 4 info - **2026-09-11** `ed3a987d45c3`: 1 info - **2026-09-11** `75c44665b715`: 2 info - **2026-09-10** `8615a9997f76`: 6 info - **2026-09-02** `e6877e252959`: 2 info - **2026-08-19** `0263312106ba`: 1 info - **2026-08-14** `2eb9f9880ef6`: 1 warning - **2026-08-11** `12e9d0ac19a9`: 1 info - **2026-07-31** `c65df608000b`: 2 info - **2026-07-30** `fad9064655ad`: 2 breaking - **2026-07-27** `e83d3358bab3`: 3 warning, 6 info - **2026-07-16** `fe536614b280`: 1 info - **2026-07-15** `3baa54bf8b3f`: 2 warning - **2026-07-09** `068d6aa15d38`: 1 info - **2026-07-09** `8da6172fc3e9`: 2 warning - **2026-07-01** `61365e38074b`: 1 info - **2026-07-01** `d026b6ff6735`: 4 info - **2026-06-30** `2046c618ab01`: 1 info - **2026-06-05** `c0d7b479cd11`: 30 warning - **2026-06-04** `df525a3b6157`: 1 info - **2026-05-30** `18d59f1bf692`: 3 info - **2026-05-19** `9f854e7c7b1c`: 1 warning, 2 info ## Changes - **2026-10-20** `c7dea159ac06`: 3 info - added the required property `data/items/active_version/renewal_policy` to the response with the `200` status - added the required property `data/items/draft_version/renewal_policy` to the response with the `200` status - added the required property `data/items/versions/items/renewal_policy` to the response with the `200` status - **2026-10-19** `92f237cd6201`: 1 info - added the required property `data/items/included_credit_grants/items/warning_tiers` to the response with the `200` status - **2026-10-15** `cdb3124e1bed`: 2 breaking, 1 info - the response property `data/items/features/items/flags/items/default_value` became nullable for the status `200` - the response property `data/items/features/items/flags/items/default_value` became optional for the status `200` - response property `data/items/features/items/flags/items/default_value` deprecated - **2026-10-06** `8eb4adb2bade`: 4 info - added the optional property `data/items/entitlements/items/quantity_rates` to the response with the `200` status - added the required property `data/items/entitlements/items/feature/event_source` to the response with the `200` status - added the required property `data/items/features/items/event_source` to the response with the `200` status - added the required property `data/items/features/items/flags/items/feature/event_source` to the response with the `200` status - **2026-09-17** `fe6c40d79596`: 6 info - added the optional property `data/items/included_credit_grants/items/price` to the response with the `200` status - added the optional property `data/items/included_credit_grants/items/tier_mode` to the response with the `200` status - added the optional property `data/items/included_credit_grants/items/unit_price` to the response with the `200` status - added the optional property `data/items/included_credit_grants/items/unit_price_decimal` to the response with the `200` status - added the required property `data/items/included_credit_grants/items/billing_mode` to the response with the `200` status - added the required property `data/items/included_credit_grants/items/price_tiers` to the response with the `200` status - **2026-09-17** `d2fb8bb90eaf`: 3 info - added the required property `data/items/credits/items/ledger_authority` to the response with the `200` status - added the required property `data/items/entitlements/items/value_credit/ledger_authority` to the response with the `200` status - added the required property `data/items/included_credit_grants/items/credit/ledger_authority` to the response with the `200` status - **2026-09-16** `d6b7758ad3d1`: 2 warning - added the new `quarterly` enum value to the `data/items/entitlements/items/overage_billing_cadence/allOf[#/components/schemas/BillingArrearsCadence]/` response property for the response status `200` - added the new `quarterly` enum value to the `data/items/included_credit_grants/items/arrears_cadence/allOf[#/components/schemas/BillingArrearsCadence]/` response property for the response status `200` - **2026-09-16** `6cf39110fd8f`: 2 info - added the optional property `data/items/entitlements/items/overage_billing_cadence` to the response with the `200` status - added the optional property `data/items/entitlements/items/overage_invoice_anchor` to the response with the `200` status - **2026-09-15** `5a677fa71c74`: 4 info - added the new optional `query` request parameter `with_published_version` - added the new optional `query` request parameter `without_entitlement_for_include_drafts` - added the optional property `params/with_published_version` to the response with the `200` status - added the optional property `params/without_entitlement_for_include_drafts` to the response with the `200` status - **2026-09-11** `ed3a987d45c3`: 1 info - removed the `daily` enum value from the `data/items/included_credit_grants/items/arrears_cadence/allOf[#/components/schemas/BillingArrearsCadence]/` response property for the response status `200` - **2026-09-11** `75c44665b715`: 2 info - added the new optional `query` request parameter `exclude_unused` - added the optional property `params/exclude_unused` to the response with the `200` status - **2026-09-10** `8615a9997f76`: 6 info - added the optional property `data/items/included_credit_grants/items/arrears_anchor` to the response with the `200` status - added the optional property `data/items/included_credit_grants/items/arrears_cadence` to the response with the `200` status - added the optional property `data/items/included_credit_grants/items/overdraft_limit` to the response with the `200` status - added the optional property `data/items/included_credit_grants/items/postpaid_rate_per_unit` to the response with the `200` status - added the optional property `data/items/included_credit_grants/items/postpaid_rate_per_unit_decimal` to the response with the `200` status - added the required property `data/items/included_credit_grants/items/postpaid_enabled` to the response with the `200` status - **2026-09-02** `e6877e252959`: 2 info - added the optional property `data/items/features/items/flags/items/rules/items/condition_groups/items/conditions/items/plan_versions` to the response with the `200` status - added the optional property `data/items/features/items/flags/items/rules/items/conditions/items/plan_versions` to the response with the `200` status - **2026-08-19** `0263312106ba`: 1 info - response property `data/items/included_credit_grants/items/can_buy_bundles` deprecated - **2026-08-14** `2eb9f9880ef6`: 1 warning - for the `query` request parameter `q`, the maxLength was set to `512` - **2026-08-11** `12e9d0ac19a9`: 1 info - added the required property `data/items/included_credit_grants/items/company_credit_amount` to the response with the `200` status - **2026-07-31** `c65df608000b`: 2 info - added the optional property `data/items/included_credit_grants/items/license_id` to the response with the `200` status - added the required property `data/items/included_credit_grants/items/scaling` to the response with the `200` status - **2026-07-30** `fad9064655ad`: 2 breaking - the response property `data/items/is_free` became nullable for the status `200` - the response property `data/items/is_free` became optional for the status `200` - **2026-07-27** `e83d3358bab3`: 3 warning, 6 info - added the new `license` enum value to the `data/items/entitlements/items/feature/feature_type` response property for the response status `200` - added the new `license` enum value to the `data/items/features/items/feature_type` response property for the response status `200` - added the new `license` enum value to the `data/items/features/items/flags/items/feature/feature_type` response property for the response status `200` - added the optional property `data/items/entitlements/items/feature/license_id` to the response with the `200` status - added the optional property `data/items/entitlements/items/feature/usage_limit_trait_id` to the response with the `200` status - added the optional property `data/items/features/items/flags/items/feature/license_id` to the response with the `200` status - added the optional property `data/items/features/items/flags/items/feature/usage_limit_trait_id` to the response with the `200` status - added the optional property `data/items/features/items/license_id` to the response with the `200` status - added the optional property `data/items/features/items/usage_limit_trait_id` to the response with the `200` status - **2026-07-16** `fe536614b280`: 1 info - added the optional property `data/items/catalogs` to the response with the `200` status - **2026-07-15** `3baa54bf8b3f`: 2 warning - for the `query` request parameter `limit`, the max was set to `250.00` - for the `query` request parameter `limit`, the min was set to `0.00` - **2026-07-09** `068d6aa15d38`: 1 info - added the required property `data/items/entitlements/items/warning_tiers` to the response with the `200` status - **2026-07-09** `8da6172fc3e9`: 2 warning - added the new `every_6_months` enum value to the `data/items/included_credit_grants/items/reset_cadence/allOf[#/components/schemas/BillingPlanCreditGrantResetCadence]/` response property for the response status `200` - added the new `quarterly` enum value to the `data/items/included_credit_grants/items/reset_cadence/allOf[#/components/schemas/BillingPlanCreditGrantResetCadence]/` response property for the response status `200` - **2026-07-01** `61365e38074b`: 1 info - added the required property `data/items/credits` to the response with the `200` status - **2026-07-01** `d026b6ff6735`: 4 info - response property `data/items/included_credit_grants/items/auto_topup_enabled` deprecated - response property `data/items/included_credit_grants/items/auto_topup_self_service` deprecated - added the required property `data/items/included_credit_grants/items/auto_topup_availability` to the response with the `200` status - added the required property `data/items/included_credit_grants/items/can_buy_bundles` to the response with the `200` status - **2026-06-30** `2046c618ab01`: 1 info - added the optional property `data/items/company_logo_url` to the response with the `200` status - **2026-06-05** `c0d7b479cd11`: 30 warning - added the new `metronome` enum value to the `data/items/billing_linked_resource/billing_provider` response property for the response status `200` - added the new `metronome` enum value to the `data/items/billing_linked_resource/originator` response property for the response status `200` - added the new `metronome` enum value to the `data/items/billing_product/prices/items/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/billing_product/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/controlled_by` response property for the response status `200` - added the new `metronome` enum value to the `data/items/currency_prices/items/monthly_price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/currency_prices/items/one_time_price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/currency_prices/items/quarterly_price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/currency_prices/items/yearly_price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/entitlements/items/billing_linked_resource/billing_provider` response property for the response status `200` - added the new `metronome` enum value to the `data/items/entitlements/items/billing_linked_resource/originator` response property for the response status `200` - added the new `metronome` enum value to the `data/items/entitlements/items/currency_prices/items/monthly_price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/entitlements/items/currency_prices/items/quarterly_price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/entitlements/items/currency_prices/items/yearly_price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/entitlements/items/metered_monthly_price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/entitlements/items/metered_quarterly_price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/entitlements/items/metered_yearly_price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/entitlements/items/usage_based_product/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/entitlements/items/value_credit/currency_prices/items/price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/entitlements/items/value_credit/price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/entitlements/items/value_credit/product/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/features/items/billing_linked_resource/billing_provider` response property for the response status `200` - added the new `metronome` enum value to the `data/items/features/items/billing_linked_resource/originator` response property for the response status `200` - added the new `metronome` enum value to the `data/items/included_credit_grants/items/credit/currency_prices/items/price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/included_credit_grants/items/credit/price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/included_credit_grants/items/credit/product/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/monthly_price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/one_time_price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/quarterly_price/provider_type` response property for the response status `200` - added the new `metronome` enum value to the `data/items/yearly_price/provider_type` response property for the response status `200` - **2026-06-04** `df525a3b6157`: 1 info - added the required property `data/items/included_credit_grants/items/rollover_percentage` to the response with the `200` status - **2026-05-30** `18d59f1bf692`: 3 info - added the new optional `query` request parameter `with_entitlements` - added the optional property `data/items/entitlements` to the response with the `200` status - added the optional property `params/with_entitlements` to the response with the `200` status - **2026-05-19** `9f854e7c7b1c`: 1 warning, 2 info - added the new `none` enum value to the `data/items/charge_type` response property for the response status `200` - response property `data/items/is_free` deprecated - added the required property `data/items/billing_strategy` to the response with the `200` status --- [Operation](https://skmtc.dev/schematichq/apis/schematic-api/docs/plans/get.md) - [API](https://skmtc.dev/schematichq/apis/schematic-api.md) - [Page](https://skmtc.dev/schematichq/apis/schematic-api/changes/plans/get)