---
title: "Changes to List history for a subscription"
method: GET
path: "/subscriptions/{subscription_id}/history"
---

# Changes to List history for a subscription

`GET /subscriptions/{subscription_id}/history`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 19 revisions.

- **2026-10-19** (v1) `4f35a8c6ea4d`: 13 breaking, 1 warning, 1 info
- **2026-07-09** (v1) `e1ac347eb3c5`: 1 info

## Changes

- **2026-10-19** (v1) `4f35a8c6ea4d`: 13 breaking, 1 warning, 1 info
  - for the `query` request parameter `order_by`, default value was changed from `occurred_at[DESC]` to `id[DESC]`
  - added `#/components/schemas/CountryCodeNonSupported` to the `data/items/detail/allOf[#/components/schemas/SubscriptionHistoryDetail]/oneOf[subschema #12: Created]/address/anyOf[subschema #1: Address]/country_code/allOf[#/components/schemas/CountryCode]/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/CountryCodeNonSupported` to the `data/items/detail/allOf[#/components/schemas/SubscriptionHistoryDetail]/oneOf[subschema #12: Created]/items/anyOf[subschema #1]/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/detail/allOf[#/components/schemas/SubscriptionHistoryDetail]/oneOf[subschema #12: Created]/items/anyOf[subschema #1]/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/CountryCodeNonSupported` to the `data/items/detail/allOf[#/components/schemas/SubscriptionHistoryDetail]/oneOf[subschema #19: Item added]/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/detail/allOf[#/components/schemas/SubscriptionHistoryDetail]/oneOf[subschema #19: Item added]/price/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/CountryCodeNonSupported` to the `data/items/detail/allOf[#/components/schemas/SubscriptionHistoryDetail]/oneOf[subschema #20: Item quantity updated]/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/detail/allOf[#/components/schemas/SubscriptionHistoryDetail]/oneOf[subschema #20: Item quantity updated]/price/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/CountryCodeNonSupported` to the `data/items/detail/allOf[#/components/schemas/SubscriptionHistoryDetail]/oneOf[subschema #21: Item removed]/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/detail/allOf[#/components/schemas/SubscriptionHistoryDetail]/oneOf[subschema #21: Item removed]/price/allOf[subschema #1: Price]/unit_price_overrides/items/country_codes/items/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/CountryCodeNonSupported` to the `data/items/detail/allOf[#/components/schemas/SubscriptionHistoryDetail]/oneOf[subschema #22: One-off charge applied]/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/detail/allOf[#/components/schemas/SubscriptionHistoryDetail]/oneOf[subschema #22: One-off charge applied]/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/CountryCodeNonSupported` to the `data/items/detail/allOf[#/components/schemas/SubscriptionHistoryDetail]/oneOf[subschema #2: Address updated]/address/allOf[subschema #1: Address]/country_code/allOf[#/components/schemas/CountryCode]/` response property `oneOf` list for the response status `200`
  - added the new `eu_withdrawal` enum value to the `data/items/reason/allOf[#/components/schemas/SubscriptionHistoryReason]/anyOf[subschema #1: Subscription History Reason]/` response property for the response status `200`
  - added the enum value `eu_withdrawal` to the property `items/` of the `query` request parameter `reason`
- **2026-07-09** (v1) `e1ac347eb3c5`: 1 info
  - endpoint added

---

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