---
title: "Changes to List prices"
method: GET
path: "/prices"
---

# Changes to List prices

`GET /prices`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 19 revisions.

- **2026-10-19** (v1) `4f35a8c6ea4d`: 2 breaking
- **2026-07-09** (v1) `e1ac347eb3c5`: 4 warning, 5 info
- **2026-02-02** (v1) `9ba8be0f2006`: 6 breaking, 1 warning, 21 info
- **2025-04-25** (v1) `c4b1322e66ca`: 3 breaking
- **2025-03-07** (v1) `a3359d7731fd`: 11 breaking, 3 info
- **2024-12-06** (v1) `274e5b2be190`: 2 breaking, 2 warning, 229 info
- **2024-05-14** (v1) `61fe84bfd516`: 2 breaking, 5 info
- **2024-02-19** (v1) `a4a4068ff792`: 11 breaking, 3 warning, 4 info

## Changes

- **2026-10-19** (v1) `4f35a8c6ea4d`: 2 breaking
  - added `#/components/schemas/CountryCodeNonSupported` to the `data/items/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/unit_price_overrides/items/country_codes/items/` response property `oneOf` list for the response status `200`
- **2026-07-09** (v1) `e1ac347eb3c5`: 4 warning, 5 info
  - added the new `CLP` enum value to the `data/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/items/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/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/items/unit_price_overrides/items/unit_price/allOf[subschema #1: Money]/currency_code` response property for the response status `200`
  - added the new optional `header` request parameter `Skip-Count`
  - added the new optional `query` request parameter `billing_cycle.frequency`
  - added the new optional `query` request parameter `billing_cycle.interval`
  - added the optional property `data/items/trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price` to the response with the `200` status
  - added the optional property `data/items/trial_period/anyOf[subschema #1: Price Trial Duration]/unit_price_overrides` to the response with the `200` status
- **2026-02-02** (v1) `9ba8be0f2006`: 6 breaking, 1 warning, 21 info
  - for the `query` request parameter `status`, default value `active` was added
  - 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 the optional property `error/errors` from the response with the `default` status
  - added the optional property `data/items/product` to the response with the `200` status
  - added `#/components/schemas/ApiError` to the `error` response property `allOf` list for the response status `default`
  - removed `#/components/schemas/price, subschema #2` from the `data/items/` 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/items/billing_cycle` to the response with the `200` status
  - added the required property `data/items/created_at` to the response with the `200` status
  - added the required property `data/items/custom_data` to the response with the `200` status
  - added the required property `data/items/description` to the response with the `200` status
  - added the required property `data/items/id` to the response with the `200` status
  - added the required property `data/items/import_meta` to the response with the `200` status
  - added the required property `data/items/name` to the response with the `200` status
  - added the required property `data/items/product_id` to the response with the `200` status
  - added the required property `data/items/quantity` to the response with the `200` status
  - added the required property `data/items/status` to the response with the `200` status
  - added the required property `data/items/tax_mode` to the response with the `200` status
  - added the required property `data/items/trial_period` to the response with the `200` status
  - added the required property `data/items/type` to the response with the `200` status
  - added the required property `data/items/unit_price` to the response with the `200` status
  - added the required property `data/items/unit_price_overrides` to the response with the `200` status
  - added the required property `data/items/updated_at` to the response with the `200` status
- **2025-04-25** (v1) `c4b1322e66ca`: 3 breaking
  - the response property `meta/pagination/estimated_total` became optional for the status `200`
  - the `data/items/allOf[subschema #1: Price]/description` response property's maxLength was increased from `200` to `500` for the response status `200`
  - the `data/items/allOf[subschema #1: Price]/name` response property's maxLength was increased from `50` to `150` for the response status `200`
- **2025-03-07** (v1) `a3359d7731fd`: 11 breaking, 3 info
  - the `data/items/allOf[subschema #1: 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/allOf[subschema #2]/product/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `200`
  - the `data/items/allOf[subschema #1: 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/allOf[subschema #2]/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/items/allOf[subschema #1: 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/allOf[subschema #2]/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/items/allOf[subschema #1: 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/allOf[subschema #2]/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/allOf[subschema #1: Price]/trial_period` response property `oneOf` list for the response status `200`
  - the `data/items/allOf[subschema #1: 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/allOf[subschema #2]/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/allOf[subschema #1: Price]/trial_period` response property `oneOf` list for the response status `200`
  - the response required property `data/items/allOf[subschema #1: Price]/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200`
  - the response required property `data/items/allOf[subschema #2]/product/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200`
- **2024-12-06** (v1) `274e5b2be190`: 2 breaking, 2 warning, 229 info
  - added `#/components/schemas/country_code_supported` to the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property `oneOf` list for the response status `200`
  - the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response's property type changed from `string` to no type for status `200`
  - added the new `VND` enum value to the `data/items/allOf[subschema #1: Price]/unit_price/currency_code` response property for the response status `200`
  - added the new `VND` enum value to the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/unit_price/currency_code` response property for the response status `200`
  - removed the `AD` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AE` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AG` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AI` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AL` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AM` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AO` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AR` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AS` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AT` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AU` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AW` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AX` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `AZ` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BA` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BB` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BD` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BE` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BF` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BG` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BH` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BI` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BJ` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BL` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BM` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BN` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BO` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BQ` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BR` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BS` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BT` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BV` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BW` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `BZ` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `CA` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - removed the `CC` enum value from the `data/items/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property for the response status `200`
  - …193 more
- **2024-05-14** (v1) `61fe84bfd516`: 2 breaking, 5 info
  - added `#/components/schemas/duration` to the `data/items/allOf[subschema #1: Price]/billing_cycle` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/duration` to the `data/items/allOf[subschema #1: Price]/trial_period` response property `oneOf` list for the response status `200`
  - added the optional property `data/items/allOf[subschema #1: Price]/created_at` to the response with the `200` status
  - added the optional property `data/items/allOf[subschema #1: Price]/updated_at` to the response with the `200` status
  - added the optional property `data/items/allOf[subschema #2]/product/updated_at` to the response with the `200` status
  - removed `#/components/schemas/period` from the `data/items/allOf[subschema #1: Price]/billing_cycle` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/period` from the `data/items/allOf[subschema #1: Price]/trial_period` response property `oneOf` list for the response status `200`
- **2024-02-19** (v1) `a4a4068ff792`: 11 breaking, 3 warning, 4 info
  - for the `query` request parameter `per_page`, default value was changed from `10` to `50`
  - added `#/components/schemas/custom_data, subschema #2` to the `data/items/allOf[subschema #1: Price]/custom_data` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/custom_data, subschema #2` to the `data/items/allOf[subschema #2]/product/custom_data` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/import_meta, subschema #2` to the `data/items/allOf[subschema #1: Price]/import_meta` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/import_meta, subschema #2` to the `data/items/allOf[subschema #2]/product/import_meta` response property `oneOf` list for the response status `200`
  - the `data/items/allOf[subschema #1: Price]/custom_data` response's property type changed from `object, null` to no type for status `200`
  - the `data/items/allOf[subschema #1: Price]/import_meta` response's property type changed from `object, null` to no type for status `200`
  - the `data/items/allOf[subschema #2]/product/custom_data` response's property type changed from `object, null` to no type for status `200`
  - the `data/items/allOf[subschema #2]/product/import_meta` response's property type changed from `object, null` to no type for status `200`
  - removed the required property `data/items/allOf[subschema #1: Price]/import_meta/imported_from` from the response with the `200` status
  - removed the required property `data/items/allOf[subschema #2]/product/import_meta/imported_from` from the response with the `200` status
  - for the `query` request parameter `per_page`, the max was set to `200.00`
  - removed the optional property `data/items/allOf[subschema #1: Price]/import_meta/external_id` from the response with the `200` status
  - removed the optional property `data/items/allOf[subschema #2]/product/import_meta/external_id` from the response with the `200` status
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `500`
  - the `status` response's property default value `active` was added for the status `200`
  - the `per_page` response's property default value `10` was removed for the status `200`

---

[Operation](https://skmtc.dev/paddlehq/apis/paddle-api/docs/prices/get.md) - [API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [Page](https://skmtc.dev/paddlehq/apis/paddle-api/changes/prices/get)
