--- title: "Changes to Preview an update to a subscription" method: PATCH path: "/subscriptions/{subscription_id}/preview" --- # Changes to Preview an update to a subscription `PATCH /subscriptions/{subscription_id}/preview` > Every recorded change to this operation, newest first. ## Timeline Changed in 13 of 19 revisions. - **2026-10-19** (v1) `4f35a8c6ea4d`: 4 breaking, 5 info - **2026-07-09** (v1) `e1ac347eb3c5`: 22 warning, 15 info - **2026-02-02** (v1) `9ba8be0f2006`: 80 breaking, 34 warning, 144 info - **2025-05-27** (v1) `e57c515077cc`: 1 breaking, 1 info - **2025-04-25** (v1) `c4b1322e66ca`: 2 breaking, 6 info - **2025-03-07** (v1) `a3359d7731fd`: 31 breaking, 7 info - **2025-02-03** (v1) `50bbef23e6a1`: 6 breaking, 6 warning, 6 info - **2024-12-19** (v1) `6be8d2a4c7e1`: 2 breaking - **2024-12-06** (v1) `274e5b2be190`: 474 breaking, 11 warning, 242 info - **2024-08-06** (v1) `968e505782d4`: 18 info - **2024-07-05** (v1) `8f7044f788af`: 1 info - **2024-05-14** (v1) `61fe84bfd516`: 11 breaking, 20 warning, 11 info - **2024-02-19** (v1) `a4a4068ff792`: 67 breaking, 21 warning, 21 info ## Changes - **2026-10-19** (v1) `4f35a8c6ea4d`: 4 breaking, 5 info - removed `#/components/schemas/Duration` from the `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/trial_period` request property `anyOf` list - removed `#/components/schemas/Duration` from the `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/trial_period` request property `anyOf` list - added `#/components/schemas/CountryCodeNonSupported` to the `data/items/items/price/allOf[subschema #1: Price]/trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price_overrides/items/country_codes/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/CountryCodeNonSupported` to the `data/items/items/price/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property `oneOf` list for the response status `200` - added `#/components/schemas/PriceTrialDurationCreate` to the `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/trial_period` request property `anyOf` list - added `#/components/schemas/PriceTrialDurationCreate` to the `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/trial_period` request property `anyOf` list - added `#/components/schemas/CountryCodeNonSupported` to the `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price_overrides/items/country_codes/items/` request property `oneOf` list - added `#/components/schemas/CountryCodeNonSupported` to the `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price_overrides/items/country_codes/items/` request property `oneOf` list - added the required property `data/management_urls/allOf[subschema #1: Subscription Management Urls]/view_subscription` to the response with the `200` status - **2026-07-09** (v1) `e1ac347eb3c5`: 22 warning, 15 info - added the new `CLP` enum value to the `data/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `CLP` enum value to the `data/immediate_transaction/anyOf[subschema #1: Next transaction]/adjustments/items/totals/allOf[subschema #1: AdjustmentTotals]/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `CLP` enum value to the `data/immediate_transaction/anyOf[subschema #1: Next transaction]/details/totals/allOf[#/components/schemas/TransactionTotals]/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `CLP` enum value to the `data/items/items/price/allOf[subschema #1: Price]/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `200` - added the new `CLP` enum value to the `data/items/items/price/allOf[subschema #1: Price]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `200` - added the new `CLP` enum value to the `data/next_transaction/anyOf[subschema #1: Next transaction]/adjustments/items/totals/allOf[subschema #1: AdjustmentTotals]/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `CLP` enum value to the `data/next_transaction/anyOf[subschema #1: Next transaction]/details/totals/allOf[#/components/schemas/TransactionTotals]/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `CLP` enum value to the `data/recurring_transaction_details/allOf[subschema #1: Transaction details (preview)]/totals/allOf[#/components/schemas/TransactionTotals]/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `CLP` enum value to the `data/update_summary/anyOf[subschema #1: Subscription preview update summary]/charge/allOf[subschema #1: Money]/currency_code` response property for the response status `200` - added the new `CLP` enum value to the `data/update_summary/anyOf[subschema #1: Subscription preview update summary]/credit/allOf[subschema #1: Money]/currency_code` response property for the response status `200` - added the new `CLP` enum value to the `data/update_summary/anyOf[subschema #1: Subscription preview update summary]/result/allOf[subschema #1: UpdateSummaryResult]/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `PEN` enum value to the `data/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `PEN` enum value to the `data/immediate_transaction/anyOf[subschema #1: Next transaction]/adjustments/items/totals/allOf[subschema #1: AdjustmentTotals]/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `PEN` enum value to the `data/immediate_transaction/anyOf[subschema #1: Next transaction]/details/totals/allOf[#/components/schemas/TransactionTotals]/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `PEN` enum value to the `data/items/items/price/allOf[subschema #1: Price]/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `200` - added the new `PEN` enum value to the `data/items/items/price/allOf[subschema #1: Price]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `200` - added the new `PEN` enum value to the `data/next_transaction/anyOf[subschema #1: Next transaction]/adjustments/items/totals/allOf[subschema #1: AdjustmentTotals]/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `PEN` enum value to the `data/next_transaction/anyOf[subschema #1: Next transaction]/details/totals/allOf[#/components/schemas/TransactionTotals]/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `PEN` enum value to the `data/recurring_transaction_details/allOf[subschema #1: Transaction details (preview)]/totals/allOf[#/components/schemas/TransactionTotals]/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `PEN` enum value to the `data/update_summary/anyOf[subschema #1: Subscription preview update summary]/charge/allOf[subschema #1: Money]/currency_code` response property for the response status `200` - added the new `PEN` enum value to the `data/update_summary/anyOf[subschema #1: Subscription preview update summary]/credit/allOf[subschema #1: Money]/currency_code` response property for the response status `200` - added the new `PEN` enum value to the `data/update_summary/anyOf[subschema #1: Subscription preview update summary]/result/allOf[subschema #1: UpdateSummaryResult]/currency_code/allOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `CLP` enum value to the request property `currency_code/allOf[subschema #1: Currency code]/` - added the new `CLP` enum value to the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price/allOf[subschema #1: Money]/currency_code` - added the new `CLP` enum value to the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code` - added the new `CLP` enum value to the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price/allOf[subschema #1: Money]/currency_code` - added the new `CLP` enum value to the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code` - added the new `PEN` enum value to the request property `currency_code/allOf[subschema #1: Currency code]/` - added the new `PEN` enum value to the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price/allOf[subschema #1: Money]/currency_code` - added the new `PEN` enum value to the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateWithProductID]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code` - added the new `PEN` enum value to the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price/allOf[subschema #1: Money]/currency_code` - added the new `PEN` enum value to the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateWithProduct]/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code` - added the optional property `data/items/items/price/allOf[subschema #1: Price]/trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price` to the response with the `200` status - added the optional property `data/items/items/price/allOf[subschema #1: Price]/trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price_overrides` to the response with the `200` status - added `#/components/schemas/SubscriptionDiscount` to the `data/discount` response property `anyOf` list for the response status `200` - removed `#/components/schemas/DiscountSubscription` from the `data/discount` response property `anyOf` list for the response status `200` - added the required property `data/consent_requirements` to the response with the `200` status - **2026-02-02** (v1) `9ba8be0f2006`: 80 breaking, 34 warning, 144 info - added the new path request parameter `subscription_id` - request body became required - added `#/components/schemas/AddressId` to the `address_id` request property `allOf` list - added `#/components/schemas/CollectionMode` to the `collection_mode` request property `allOf` list - added `#/components/schemas/CurrencyCode` to the `currency_code` request property `allOf` list - added `#/components/schemas/CustomerId` to the `customer_id` request property `allOf` list - added `#/components/schemas/SubscriptionOnPaymentFailure` to the `on_payment_failure` request property `allOf` list - added `#/components/schemas/Timestamp` to the `next_billed_at` request property `allOf` list - the request property `discount` became not nullable - removed the enum value `ARS` of the request property `currency_code` - removed the enum value `AUD` of the request property `currency_code` - removed the enum value `BRL` of the request property `currency_code` - removed the enum value `CAD` of the request property `currency_code` - removed the enum value `CHF` of the request property `currency_code` - removed the enum value `CNY` of the request property `currency_code` - removed the enum value `COP` of the request property `currency_code` - removed the enum value `CZK` of the request property `currency_code` - removed the enum value `DKK` of the request property `currency_code` - removed the enum value `EUR` of the request property `currency_code` - removed the enum value `GBP` of the request property `currency_code` - removed the enum value `HKD` of the request property `currency_code` - removed the enum value `HUF` of the request property `currency_code` - removed the enum value `ILS` of the request property `currency_code` - removed the enum value `INR` of the request property `currency_code` - removed the enum value `JPY` of the request property `currency_code` - removed the enum value `KRW` of the request property `currency_code` - removed the enum value `MXN` of the request property `currency_code` - removed the enum value `NOK` of the request property `currency_code` - removed the enum value `NZD` of the request property `currency_code` - removed the enum value `PLN` of the request property `currency_code` - removed the enum value `RUB` of the request property `currency_code` - removed the enum value `SEK` of the request property `currency_code` - removed the enum value `SGD` of the request property `currency_code` - removed the enum value `THB` of the request property `currency_code` - removed the enum value `TRY` of the request property `currency_code` - removed the enum value `TWD` of the request property `currency_code` - removed the enum value `UAH` of the request property `currency_code` - removed the enum value `USD` of the request property `currency_code` - removed the enum value `VND` of the request property `currency_code` - removed the enum value `ZAR` of the request property `currency_code` - …218 more - **2025-05-27** (v1) `e57c515077cc`: 1 breaking, 1 info - added `#/components/schemas/import_meta_subscription` to the `data/import_meta` response property `oneOf` list for the response status `200` - removed `#/components/schemas/import_meta` from the `data/import_meta` response property `oneOf` list for the response status `200` - **2025-04-25** (v1) `c4b1322e66ca`: 2 breaking, 6 info - the `data/items/items/price/description` response property's maxLength was increased from `200` to `500` for the response status `200` - the `data/items/items/price/name` response property's maxLength was increased from `50` to `150` for the response status `200` - the `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/description` request property's maxLength was increased from `200` to `500` - the `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/name` request property's maxLength was increased from `50` to `150` - the `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/description` request property's maxLength was increased from `200` to `500` - the `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/name` request property's maxLength was increased from `50` to `150` - added the optional write-only property `data/immediate_transaction/oneOf[subschema #1: Next transaction]/adjustments/items/tax_mode` to the response with the `200` status - added the optional write-only property `data/next_transaction/oneOf[subschema #1: Next transaction]/adjustments/items/tax_mode` to the response with the `200` status - **2025-03-07** (v1) `a3359d7731fd`: 31 breaking, 7 info - the `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `200` - the `data/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `200` - the `data/items/items/price/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `200` - the `data/items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `200` - the `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `200` - the `data/recurring_transaction_details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `200` - the `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's minLength was decreased from `1` to `0` for the response status `200` - the `data/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's minLength was decreased from `1` to `0` for the response status `200` - the `data/items/items/price/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's minLength was decreased from `1` to `0` for the response status `200` - the `data/items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's minLength was decreased from `1` to `0` for the response status `200` - the `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's minLength was decreased from `1` to `0` for the response status `200` - the `data/recurring_transaction_details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's minLength was decreased from `1` to `0` for the response status `200` - added `#/components/schemas/external_id, subschema #2` to the `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property `oneOf` list for the response status `200` - added `#/components/schemas/external_id, subschema #2` to the `data/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property `oneOf` list for the response status `200` - added `#/components/schemas/external_id, subschema #2` to the `data/items/items/price/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property `oneOf` list for the response status `200` - added `#/components/schemas/external_id, subschema #2` to the `data/items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property `oneOf` list for the response status `200` - added `#/components/schemas/external_id, subschema #2` to the `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property `oneOf` list for the response status `200` - added `#/components/schemas/external_id, subschema #2` to the `data/recurring_transaction_details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property `oneOf` list for the response status `200` - added `#/components/schemas/migration_provider_public` to the `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` response property `oneOf` list for the response status `200` - added `#/components/schemas/migration_provider_public` to the `data/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` response property `oneOf` list for the response status `200` - added `#/components/schemas/migration_provider_public` to the `data/items/items/price/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` response property `oneOf` list for the response status `200` - added `#/components/schemas/migration_provider_public` to the `data/items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` response property `oneOf` list for the response status `200` - added `#/components/schemas/migration_provider_public` to the `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` response property `oneOf` list for the response status `200` - added `#/components/schemas/migration_provider_public` to the `data/recurring_transaction_details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` response property `oneOf` list for the response status `200` - added `#/components/schemas/price_trial_duration` to the `data/items/items/price/trial_period` response property `oneOf` list for the response status `200` - the `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response's property type changed from `string, null` to no type for status `200` - the `data/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response's property type changed from `string, null` to no type for status `200` - the `data/items/items/price/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response's property type changed from `string, null` to no type for status `200` - the `data/items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response's property type changed from `string, null` to no type for status `200` - the `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response's property type changed from `string, null` to no type for status `200` - the `data/recurring_transaction_details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response's property type changed from `string, null` to no type for status `200` - removed `#/components/schemas/duration` from the `data/items/items/price/trial_period` response property `oneOf` list for the response status `200` - the response required property `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200` - the response required property `data/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200` - the response required property `data/items/items/price/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200` - the response required property `data/items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200` - the response required property `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200` - the response required property `data/recurring_transaction_details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/product/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200` - **2025-02-03** (v1) `50bbef23e6a1`: 6 breaking, 6 warning, 6 info - added `#/components/schemas/transaction_item_proration, subschema #2` to the `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #2]/proration` response property `oneOf` list for the response status `200` - added `#/components/schemas/transaction_item_proration, subschema #2` to the `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #2]/proration` response property `oneOf` list for the response status `200` - added `#/components/schemas/transaction_item_proration, subschema #2` to the `data/recurring_transaction_details/line_items/items/allOf[subschema #2]/proration` response property `oneOf` list for the response status `200` - the `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #2]/proration` response's property type changed from `object` to no type for status `200` - the `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #2]/proration` response's property type changed from `object` to no type for status `200` - the `data/recurring_transaction_details/line_items/items/allOf[subschema #2]/proration` response's property type changed from `object` to no type for status `200` - removed the optional property `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #2]/proration/billing_period` from the response with the `200` status - removed the optional property `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #2]/proration/rate` from the response with the `200` status - removed the optional property `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #2]/proration/billing_period` from the response with the `200` status - removed the optional property `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #2]/proration/rate` from the response with the `200` status - removed the optional property `data/recurring_transaction_details/line_items/items/allOf[subschema #2]/proration/billing_period` from the response with the `200` status - removed the optional property `data/recurring_transaction_details/line_items/items/allOf[subschema #2]/proration/rate` from the response with the `200` status - added the optional property `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/proration` to the response with the `200` status - added the optional property `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/proration` to the response with the `200` status - added the optional property `data/recurring_transaction_details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/proration` to the response with the `200` status - the response optional property `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #2]/proration` became not read-only for the status `200` - the response optional property `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #2]/proration` became not read-only for the status `200` - the response optional property `data/recurring_transaction_details/line_items/items/allOf[subschema #2]/proration` became not read-only for the status `200` - **2024-12-19** (v1) `6be8d2a4c7e1`: 2 breaking - added `#/components/schemas/timestamp, subschema #2` to the `data/discount/oneOf[subschema #1: SubscriptionDiscountTimePeriod]/starts_at` response property `oneOf` list for the response status `200` - the `data/discount/oneOf[subschema #1: SubscriptionDiscountTimePeriod]/starts_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `200` - **2024-12-06** (v1) `274e5b2be190`: 474 breaking, 11 warning, 242 info - removed the enum value `AD` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AD` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AE` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AE` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AG` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AG` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AI` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AI` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AL` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AL` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AM` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AM` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AO` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AO` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AR` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AR` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AS` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AS` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AT` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AT` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AU` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AU` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AW` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AW` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AX` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AX` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AZ` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `AZ` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `BA` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `BA` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `BB` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `BB` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `BD` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `BD` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `BE` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `BE` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `BF` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `BF` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `BG` of the request property `items/items/oneOf[subschema #2: Non-catalog price for an existing product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - removed the enum value `BG` of the request property `items/items/oneOf[subschema #3: Non-catalog price and product]/price/allOf[subschema #1: TransactionPriceCreateBase]/unit_price_overrides/items/country_codes/items/` - …687 more - **2024-08-06** (v1) `968e505782d4`: 18 info - api operation id `preview-subscription` removed and replaced with `preview-subscription-update` - added `#/components/schemas/subscription_item_create_with_price, #/components/schemas/subscription_item_create_with_price_and_product` to the `items/items/` request property `oneOf` list - the response optional property `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/unit_totals/discount` became read-only for the status `200` - the response optional property `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/unit_totals/subtotal` became read-only for the status `200` - the response optional property `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/unit_totals/tax` became read-only for the status `200` - the response optional property `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/unit_totals/total` became read-only for the status `200` - the response optional property `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/unit_totals/discount` became read-only for the status `200` - the response optional property `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/unit_totals/subtotal` became read-only for the status `200` - the response optional property `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/unit_totals/tax` became read-only for the status `200` - the response optional property `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/unit_totals/total` became read-only for the status `200` - the response optional property `data/recurring_transaction_details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/unit_totals/discount` became read-only for the status `200` - the response optional property `data/recurring_transaction_details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/unit_totals/subtotal` became read-only for the status `200` - the response optional property `data/recurring_transaction_details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/unit_totals/tax` became read-only for the status `200` - the response optional property `data/recurring_transaction_details/line_items/items/allOf[subschema #1: Transaction line item (preview)]/unit_totals/total` became read-only for the status `200` - the response property `data/update_summary/oneOf[subschema #1: Preview subscription update summary -> subschema #1: Subscription preview update summary]/charge/amount` became required for the status `200` - the response property `data/update_summary/oneOf[subschema #1: Preview subscription update summary -> subschema #1: Subscription preview update summary]/charge/currency_code` became required for the status `200` - the response property `data/update_summary/oneOf[subschema #1: Preview subscription update summary -> subschema #1: Subscription preview update summary]/credit/amount` became required for the status `200` - the response property `data/update_summary/oneOf[subschema #1: Preview subscription update summary -> subschema #1: Subscription preview update summary]/credit/currency_code` became required for the status `200` - **2024-07-05** (v1) `8f7044f788af`: 1 info - added the optional property `data/items/items/product` to the response with the `200` status - **2024-05-14** (v1) `61fe84bfd516`: 11 breaking, 20 warning, 11 info - request property `on_payment_failure` was restricted to a list of enum values - removed `#/components/schemas/subscription_on_payment_failure, subschema #2` from the `on_payment_failure` request property `oneOf` list - the `items/items/` request property type changed from `object` to no type - the `on_payment_failure` request property type changed from no type to `string` - added `#/components/schemas/duration` to the `data/items/items/price/billing_cycle` response property `oneOf` list for the response status `200` - added `#/components/schemas/duration` to the `data/items/items/price/trial_period` response property `oneOf` list for the response status `200` - added `#/components/schemas/timestamp, subschema #2` to the `data/discount/oneOf[subschema #1: Subscription discount]/ends_at` response property `oneOf` list for the response status `200` - the `data/discount/oneOf[subschema #1: Subscription discount]/ends_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `200` - the `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/` response's property type changed from `object` to no type for status `200` - the `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/` response's property type changed from `object` to no type for status `200` - the `data/recurring_transaction_details/line_items/items/` response's property type changed from `object` to no type for status `200` - removed the request property `items/items/price_id` - removed the request property `items/items/quantity` - removed the optional property `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/price_id` from the response with the `200` status - removed the optional property `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/product` from the response with the `200` status - removed the optional property `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/quantity` from the response with the `200` status - removed the optional property `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/tax_rate` from the response with the `200` status - removed the optional property `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/totals` from the response with the `200` status - removed the optional property `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/unit_totals` from the response with the `200` status - removed the optional property `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/price_id` from the response with the `200` status - removed the optional property `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/product` from the response with the `200` status - removed the optional property `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/quantity` from the response with the `200` status - removed the optional property `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/tax_rate` from the response with the `200` status - removed the optional property `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/totals` from the response with the `200` status - removed the optional property `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/unit_totals` from the response with the `200` status - removed the optional property `data/recurring_transaction_details/line_items/items/price_id` from the response with the `200` status - removed the optional property `data/recurring_transaction_details/line_items/items/product` from the response with the `200` status - removed the optional property `data/recurring_transaction_details/line_items/items/quantity` from the response with the `200` status - removed the optional property `data/recurring_transaction_details/line_items/items/tax_rate` from the response with the `200` status - removed the optional property `data/recurring_transaction_details/line_items/items/totals` from the response with the `200` status - removed the optional property `data/recurring_transaction_details/line_items/items/unit_totals` from the response with the `200` status - the `on_payment_failure` request property default value `prevent_change` was added - added the new `apply_change` enum value to the request property `on_payment_failure` - added the new `prevent_change` enum value to the request property `on_payment_failure` - added `#/components/schemas/subscription_update_item` to the `items/items/` request property `oneOf` list - added the optional property `data/items/items/price/created_at` to the response with the `200` status - added the optional property `data/items/items/price/updated_at` to the response with the `200` status - added `#/components/schemas/transaction_preview_line_item, subschema #2` to the `data/immediate_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/` response property `allOf` list for the response status `200` - added `#/components/schemas/transaction_preview_line_item, subschema #2` to the `data/next_transaction/oneOf[subschema #1: Next transaction]/details/line_items/items/` response property `allOf` list for the response status `200` - added `#/components/schemas/transaction_preview_line_item, subschema #2` to the `data/recurring_transaction_details/line_items/items/` response property `allOf` list for the response status `200` - …2 more - …earlier changes are on the page: https://skmtc.dev/paddlehq/apis/paddle-api/changes/subscriptions/:subscription_id/preview/patch --- [Operation](https://skmtc.dev/paddlehq/apis/paddle-api/docs/subscriptions/:subscription_id/preview/patch.md) - [API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [Page](https://skmtc.dev/paddlehq/apis/paddle-api/changes/subscriptions/:subscription_id/preview/patch)