--- title: "Changes to Preview prices" method: POST path: "/pricing-preview" --- # Changes to Preview prices `POST /pricing-preview` > Every recorded change to this operation, newest first. ## Timeline Changed in 13 of 19 revisions. - **2026-10-19** (v1) `4f35a8c6ea4d`: 4 breaking, 1 info - **2026-07-09** (v1) `e1ac347eb3c5`: 8 warning, 4 info - **2026-02-02** (v1) `9ba8be0f2006`: 9 breaking, 2 warning, 20 info - **2025-05-27** (v1) `e57c515077cc`: 1 warning - **2025-05-07** (v1) `aeb882657253`: 1 info - **2025-04-25** (v1) `c4b1322e66ca`: 3 breaking - **2025-03-07** (v1) `a3359d7731fd`: 16 breaking, 4 info - **2024-12-06** (v1) `274e5b2be190`: 3 breaking, 17 warning, 3 info - **2024-08-06** (v1) `968e505782d4`: 28 info - **2024-07-05** (v1) `8f7044f788af`: 1 breaking - **2024-06-17** (v1) `0ea531d339dc`: 2 warning - **2024-05-14** (v1) `61fe84bfd516`: 4 breaking, 7 info - **2024-02-19** (v1) `a4a4068ff792`: 90 breaking, 12 warning, 62 info ## Changes - **2026-10-19** (v1) `4f35a8c6ea4d`: 4 breaking, 1 info - removed `#/components/schemas/AddressPreview` from the `address` request property `anyOf` list - added `#/components/schemas/CountryCodeNonSupported` to the `data/address/anyOf[subschema #1: AddressPreview]/country_code/allOf[#/components/schemas/CountryCode]/` response property `oneOf` list for the response status `200` - added `#/components/schemas/CountryCodeNonSupported` to the `data/details/allOf[subschema #1: Price preview details]/line_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/details/allOf[subschema #1: Price preview details]/line_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/AddressPreviewCreate` to the `address` request property `anyOf` list - **2026-07-09** (v1) `e1ac347eb3c5`: 8 warning, 4 info - added the new `CLP` enum value to the `data/currency_code/anyOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `CLP` enum value to the `data/details/allOf[subschema #1: Price preview details]/line_items/items/discounts/items/discount/allOf[subschema #1: Discount]/currency_code/anyOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `CLP` enum value to the `data/details/allOf[subschema #1: Price preview details]/line_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/details/allOf[subschema #1: Price preview details]/line_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/currency_code/anyOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `PEN` enum value to the `data/details/allOf[subschema #1: Price preview details]/line_items/items/discounts/items/discount/allOf[subschema #1: Discount]/currency_code/anyOf[subschema #1: Currency code]/` response property for the response status `200` - added the new `PEN` enum value to the `data/details/allOf[subschema #1: Price preview details]/line_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/details/allOf[subschema #1: Price preview details]/line_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 request property `currency_code/anyOf[subschema #1: Currency code]/` - added the new `PEN` enum value to the request property `currency_code/anyOf[subschema #1: Currency code]/` - added the optional property `data/details/allOf[subschema #1: Price preview details]/line_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/details/allOf[subschema #1: Price preview details]/line_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 - **2026-02-02** (v1) `9ba8be0f2006`: 9 breaking, 2 warning, 20 info - added the new required request property `items` - request body became required - the request's body type changed from no type to `object` - the `data` response's property type changed from no type to `object` for status `200` - the `error` response's property type changed from `object` to no type for status `default` - removed the required property `error/code` from the response with the `default` status - removed the required property `error/detail` from the response with the `default` status - removed the required property `error/documentation_url` from the response with the `default` status - removed the required property `error/type` from the response with the `default` status - removed `#/components/schemas/transaction_pricing_preview_base, subschema #2` from the request body `allOf` list - removed the optional property `error/errors` from the response with the `default` status - added the new optional request property `address` - added the new optional request property `address_id` - added the new optional request property `business_id` - added the new optional request property `currency_code` - added the new optional request property `customer_id` - added the new optional request property `customer_ip_address` - added the new optional request property `discount_id` - added `#/components/schemas/ApiError` to the `error` response property `allOf` list for the response status `default` - removed `#/components/schemas/transaction_pricing_preview_base, subschema #2` from the `data` response property `allOf` list for the response status `200` - the response property `error` became required for the status `default` - the response property `meta` became required for the status `default` - added the required property `data/address` to the response with the `200` status - added the required property `data/address_id` to the response with the `200` status - added the required property `data/available_payment_methods` to the response with the `200` status - added the required property `data/business_id` to the response with the `200` status - added the required property `data/currency_code` to the response with the `200` status - added the required property `data/customer_id` to the response with the `200` status - added the required property `data/customer_ip_address` to the response with the `200` status - added the required property `data/details` to the response with the `200` status - added the required property `data/discount_id` to the response with the `200` status - **2025-05-27** (v1) `e57c515077cc`: 1 warning - added the new `korea_local` enum value to the `data/allOf[subschema #2]/available_payment_methods/items/` response property for the response status `200` - **2025-05-07** (v1) `aeb882657253`: 1 info - added the optional property `data/allOf[subschema #2]/details/line_items/items/discounts/items/discount/mode` to the response with the `200` status - **2025-04-25** (v1) `c4b1322e66ca`: 3 breaking - the `data/allOf[subschema #2]/details/line_items/items/discounts/items/discount/description` response property's maxLength was increased from `254` to `500` for the response status `200` - the `data/allOf[subschema #2]/details/line_items/items/price/description` response property's maxLength was increased from `200` to `500` for the response status `200` - the `data/allOf[subschema #2]/details/line_items/items/price/name` response property's maxLength was increased from `50` to `150` for the response status `200` - **2025-03-07** (v1) `a3359d7731fd`: 16 breaking, 4 info - the `data/allOf[subschema #2]/details/line_items/items/discounts/items/discount/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `200` - the `data/allOf[subschema #2]/details/line_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/allOf[subschema #2]/details/line_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/allOf[subschema #2]/details/line_items/items/discounts/items/discount/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/allOf[subschema #2]/details/line_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/allOf[subschema #2]/details/line_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` - added `#/components/schemas/external_id, subschema #2` to the `data/allOf[subschema #2]/details/line_items/items/discounts/items/discount/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/allOf[subschema #2]/details/line_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/allOf[subschema #2]/details/line_items/items/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/allOf[subschema #2]/details/line_items/items/discounts/items/discount/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/allOf[subschema #2]/details/line_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/allOf[subschema #2]/details/line_items/items/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/allOf[subschema #2]/details/line_items/items/price/trial_period` response property `oneOf` list for the response status `200` - the `data/allOf[subschema #2]/details/line_items/items/discounts/items/discount/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response's property type changed from `string, null` to no type for status `200` - the `data/allOf[subschema #2]/details/line_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/allOf[subschema #2]/details/line_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` - removed `#/components/schemas/duration` from the `data/allOf[subschema #2]/details/line_items/items/price/trial_period` response property `oneOf` list for the response status `200` - the response required property `data/allOf[subschema #2]/details/line_items/items/discounts/items/discount/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200` - the response required property `data/allOf[subschema #2]/details/line_items/items/price/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200` - the response required property `data/allOf[subschema #2]/details/line_items/items/product/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200` - **2024-12-06** (v1) `274e5b2be190`: 3 breaking, 17 warning, 3 info - added `#/components/schemas/transaction_pricing_preview_base, subschema #2` to the request body `allOf` list - the request's body type changed from `object` to no type - the `data` response's property type changed from `object` to no type for status `200` - removed the request property `address` - removed the request property `address_id` - removed the request property `business_id` - removed the request property `currency_code` - removed the request property `customer_id` - removed the request property `customer_ip_address` - removed the request property `discount_id` - removed the request property `items` - removed the optional property `data/address` from the response with the `200` status - removed the optional property `data/address_id` from the response with the `200` status - removed the optional property `data/available_payment_methods` from the response with the `200` status - removed the optional property `data/business_id` from the response with the `200` status - removed the optional property `data/currency_code` from the response with the `200` status - removed the optional property `data/customer_id` from the response with the `200` status - removed the optional property `data/customer_ip_address` from the response with the `200` status - removed the optional property `data/details` from the response with the `200` status - removed the optional property `data/discount_id` from the response with the `200` status - api operation id `price-preview` removed and replaced with `preview-prices` - added `#/components/schemas/transaction_pricing_preview_base, subschema #2` to the `data` response property `allOf` list for the response status `200` - removed the required write-only property `data/items` from the response with the `200` status - **2024-08-06** (v1) `968e505782d4`: 28 info - the request optional property `details/line_items/items/formatted_totals/discount` became read-only - the request optional property `details/line_items/items/formatted_totals/subtotal` became read-only - the request optional property `details/line_items/items/formatted_totals/tax` became read-only - the request optional property `details/line_items/items/formatted_totals/total` became read-only - the request optional property `details/line_items/items/formatted_unit_totals` became read-only - the request optional property `details/line_items/items/formatted_unit_totals/discount` became read-only - the request optional property `details/line_items/items/formatted_unit_totals/subtotal` became read-only - the request optional property `details/line_items/items/formatted_unit_totals/tax` became read-only - the request optional property `details/line_items/items/formatted_unit_totals/total` became read-only - the request optional property `details/line_items/items/unit_totals` became read-only - the request optional property `details/line_items/items/unit_totals/discount` became read-only - the request optional property `details/line_items/items/unit_totals/subtotal` became read-only - the request optional property `details/line_items/items/unit_totals/tax` became read-only - the request optional property `details/line_items/items/unit_totals/total` became read-only - the response optional property `data/details/line_items/items/formatted_totals/discount` became read-only for the status `200` - the response optional property `data/details/line_items/items/formatted_totals/subtotal` became read-only for the status `200` - the response optional property `data/details/line_items/items/formatted_totals/tax` became read-only for the status `200` - the response optional property `data/details/line_items/items/formatted_totals/total` became read-only for the status `200` - the response optional property `data/details/line_items/items/formatted_unit_totals` became read-only for the status `200` - the response optional property `data/details/line_items/items/formatted_unit_totals/discount` became read-only for the status `200` - the response optional property `data/details/line_items/items/formatted_unit_totals/subtotal` became read-only for the status `200` - the response optional property `data/details/line_items/items/formatted_unit_totals/tax` became read-only for the status `200` - the response optional property `data/details/line_items/items/formatted_unit_totals/total` became read-only for the status `200` - the response optional property `data/details/line_items/items/unit_totals` became read-only for the status `200` - the response optional property `data/details/line_items/items/unit_totals/discount` became read-only for the status `200` - the response optional property `data/details/line_items/items/unit_totals/subtotal` became read-only for the status `200` - the response optional property `data/details/line_items/items/unit_totals/tax` became read-only for the status `200` - the response optional property `data/details/line_items/items/unit_totals/total` became read-only for the status `200` - **2024-07-05** (v1) `8f7044f788af`: 1 breaking - the request property `items` became required - **2024-06-17** (v1) `0ea531d339dc`: 2 warning - the `details/line_items/items/discounts/items/discount/maximum_recurring_intervals` request property's min was set to `1.00` - the `details/line_items/items/discounts/items/discount/usage_limit` request property's min was set to `1.00` - **2024-05-14** (v1) `61fe84bfd516`: 4 breaking, 7 info - removed `#/components/schemas/period` from the `details/line_items/items/price/billing_cycle` request property `oneOf` list - removed `#/components/schemas/period` from the `details/line_items/items/price/trial_period` request property `oneOf` list - added `#/components/schemas/duration` to the `data/details/line_items/items/price/billing_cycle` response property `oneOf` list for the response status `200` - added `#/components/schemas/duration` to the `data/details/line_items/items/price/trial_period` response property `oneOf` list for the response status `200` - added `#/components/schemas/duration` to the `details/line_items/items/price/billing_cycle` request property `oneOf` list - added `#/components/schemas/duration` to the `details/line_items/items/price/trial_period` request property `oneOf` list - added the optional property `data/details/line_items/items/price/created_at` to the response with the `200` status - added the optional property `data/details/line_items/items/price/updated_at` to the response with the `200` status - added the optional property `data/details/line_items/items/product/updated_at` to the response with the `200` status - removed `#/components/schemas/period` from the `data/details/line_items/items/price/billing_cycle` response property `oneOf` list for the response status `200` - removed `#/components/schemas/period` from the `data/details/line_items/items/price/trial_period` response property `oneOf` list for the response status `200` - **2024-02-19** (v1) `a4a4068ff792`: 90 breaking, 12 warning, 62 info - the request property `address` became not nullable - the request property `address_id` became not nullable - the request property `business_id` became not nullable - the request property `customer_id` became not nullable - the request property `details/line_items/items/discounts/items/discount/code` became not nullable - the request property `details/line_items/items/discounts/items/discount/currency_code` became not nullable - the request property `details/line_items/items/discounts/items/discount/custom_data` became not nullable - the request property `details/line_items/items/discounts/items/discount/expires_at` became not nullable - the request property `details/line_items/items/discounts/items/discount/import_meta` became not nullable - the request property `details/line_items/items/price/custom_data` became not nullable - the request property `details/line_items/items/price/import_meta` became not nullable - the request property `details/line_items/items/product/custom_data` became not nullable - the request property `details/line_items/items/product/import_meta` became not nullable - the request property `discount_id` became not nullable - removed the enum value `ARS` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `AUD` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `BRL` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `CAD` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `CHF` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `CNY` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `COP` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `CZK` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `DKK` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `EUR` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `GBP` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `HKD` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `HUF` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `ILS` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `INR` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `JPY` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `KRW` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `MXN` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `NOK` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `NZD` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `PLN` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `RUB` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `SEK` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `SGD` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `THB` of the request property `details/line_items/items/discounts/items/discount/currency_code` - removed the enum value `TRY` of the request property `details/line_items/items/discounts/items/discount/currency_code` - …124 more --- [Operation](https://skmtc.dev/paddlehq/apis/paddle-api/docs/pricing-preview/post.md) - [API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [Page](https://skmtc.dev/paddlehq/apis/paddle-api/changes/pricing-preview/post)