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

# Changes to List discounts

`GET /discounts`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 19 revisions.

- **2026-07-09** (v1) `e1ac347eb3c5`: 2 warning, 1 info
- **2026-02-02** (v1) `9ba8be0f2006`: 14 breaking, 1 warning, 47 info
- **2025-05-07** (v1) `aeb882657253`: 2 info
- **2025-04-25** (v1) `c4b1322e66ca`: 2 breaking
- **2025-03-07** (v1) `a3359d7731fd`: 5 breaking, 1 info
- **2024-12-06** (v1) `274e5b2be190`: 3 breaking, 1 warning, 3 info
- **2024-02-19** (v1) `a4a4068ff792`: 15 breaking, 2 warning, 33 info

## Changes

- **2026-07-09** (v1) `e1ac347eb3c5`: 2 warning, 1 info
  - added the new `CLP` enum value to the `data/items/currency_code/anyOf[subschema #1: Currency code]/` response property for the response status `200`
  - added the new `PEN` enum value to the `data/items/currency_code/anyOf[subschema #1: Currency code]/` response property for the response status `200`
  - added the new optional `header` request parameter `Skip-Count`
- **2026-02-02** (v1) `9ba8be0f2006`: 14 breaking, 1 warning, 47 info
  - for the `query` request parameter `status`, default value `active` was added
  - response property `data/items/maximum_recurring_intervals` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/items/restrict_to` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `data/items/usage_limit` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `data/items/created_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `200`
  - the `data/items/id` response's property type changed from `string` to no type for status `200`
  - the `data/items/mode` response's property type changed from `string` to no type for status `200`
  - the `data/items/status` response's property type changed from `string` to no type for status `200`
  - the `data/items/updated_at` response's property type changed from `string` to no type, and format from `date-time` to no format 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 the optional property `error/errors` from the response with the `default` status
  - added the new optional `query` request parameter `discount_group_id`
  - added the new optional `query` request parameter `include`
  - added the optional property `data/items/discount_group` to the response with the `200` status
  - the response optional property `data/items/import_meta` became not read-only for the status `200`
  - added `#/components/schemas/ApiError` to the `error` response property `allOf` list for the response status `default`
  - added `#/components/schemas/CreatedAt` to the `data/items/created_at` response property `allOf` list for the response status `200`
  - added `#/components/schemas/DiscountId` to the `data/items/id` response property `allOf` list for the response status `200`
  - added `#/components/schemas/DiscountMode` to the `data/items/mode` response property `allOf` list for the response status `200`
  - added `#/components/schemas/DiscountStatus` to the `data/items/status` response property `allOf` list for the response status `200`
  - added `#/components/schemas/UpdatedAt` to the `data/items/updated_at` response property `allOf` list for the response status `200`
  - added `#/components/schemas/CurrencyCode, subschema #2` to the `data/items/currency_code` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/CustomData, subschema #2` to the `data/items/custom_data` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/DiscountCode, subschema #2` to the `data/items/code` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/ImportMeta, subschema #2` to the `data/items/import_meta` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/Timestamp, subschema #2` to the `data/items/expires_at` response property `anyOf` list for the response status `200`
  - the response property `data/items/amount` became required for the status `200`
  - the response property `data/items/code` became required for the status `200`
  - the response property `data/items/created_at` became required for the status `200`
  - the response property `data/items/currency_code` became required for the status `200`
  - the response property `data/items/custom_data` became required for the status `200`
  - the response property `data/items/description` became required for the status `200`
  - the response property `data/items/enabled_for_checkout` became required for the status `200`
  - the response property `data/items/expires_at` became required for the status `200`
  - the response property `data/items/id` became required for the status `200`
  - the response property `data/items/import_meta` became required for the status `200`
  - …22 more
- **2025-05-07** (v1) `aeb882657253`: 2 info
  - added the new optional `query` request parameter `mode`
  - added the optional property `data/items/mode` to the response with the `200` status
- **2025-04-25** (v1) `c4b1322e66ca`: 2 breaking
  - the response property `meta/pagination/estimated_total` became optional for the status `200`
  - the `data/items/description` response property's maxLength was increased from `254` to `500` for the response status `200`
- **2025-03-07** (v1) `a3359d7731fd`: 5 breaking, 1 info
  - the `data/items/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response property's maxLength was unset from `200` for the response status `200`
  - the `data/items/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/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/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` response property `oneOf` list for the response status `200`
  - the `data/items/import_meta/oneOf[subschema #1: ImportMeta]/external_id` response's property type changed from `string, null` to no type for status `200`
  - the response required property `data/items/import_meta/oneOf[subschema #1: ImportMeta]/imported_from` became read-only for the status `200`
- **2024-12-06** (v1) `274e5b2be190`: 3 breaking, 1 warning, 3 info
  - removed the enum value `expired` from the property `items/` of the `query` request parameter `status`
  - removed the enum value `used` from the property `items/` of the `query` request parameter `status`
  - the `data/items/code/oneOf[subschema #1: Discount code]/` response property's maxLength was increased from `16` to `32` for the response status `200`
  - added the new `VND` enum value to the `data/items/currency_code/oneOf[subschema #1: Currency code]/` response property for the response status `200`
  - removed the `expired` enum value from the `data/items/status` response property for the response status `200`
  - removed the `used` enum value from the `data/items/status` response property for the response status `200`
  - the `data/items/code/oneOf[subschema #1: Discount code]/` response's property pattern was changed from `^[a-zA-Z0-9]{1,16}$` to `^[a-zA-Z0-9]{1,32}$` for the status `200`
- **2024-02-19** (v1) `a4a4068ff792`: 15 breaking, 2 warning, 33 info
  - for the `query` request parameter `per_page`, default value was changed from `10` to `50`
  - the `data/items/code` response property's maxLength was unset from `16` for the response status `200`
  - the `data/items/currency_code` response property's maxLength was unset from `3` for the response status `200`
  - the `data/items/currency_code` response property's minLength was decreased from `3` to `0` for the response status `200`
  - added `#/components/schemas/currency_code, subschema #2` to the `data/items/currency_code` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/custom_data, subschema #2` to the `data/items/custom_data` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/discount_code, subschema #2` to the `data/items/code` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/import_meta, subschema #2` to the `data/items/import_meta` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/timestamp, subschema #2` to the `data/items/expires_at` response property `oneOf` list for the response status `200`
  - the `data/items/code` response's property type changed from `string, null` to no type for status `200`
  - the `data/items/currency_code` response's property type changed from `string, null` to no type for status `200`
  - the `data/items/custom_data` response's property type changed from `object, null` to no type for status `200`
  - the `data/items/expires_at` response's property type changed from `string, null` to no type, and format from `date-time` to no format for status `200`
  - the `data/items/import_meta` response's property type changed from `object, null` to no type for status `200`
  - removed the required property `data/items/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/import_meta/external_id` from the response with the `200` status
  - 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`
  - removed the `ARS` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `AUD` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `BRL` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `CAD` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `CHF` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `CNY` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `COP` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `CZK` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `DKK` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `EUR` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `GBP` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `HKD` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `HUF` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `ILS` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `INR` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `JPY` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `KRW` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `MXN` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `NOK` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `NZD` enum value from the `data/items/currency_code` response property for the response status `200`
  - removed the `PLN` enum value from the `data/items/currency_code` response property for the response status `200`
  - …10 more

---

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