--- title: "Changes to Get subscription details" method: GET path: "/api/v1/subscriptions/{subscription_id}" --- # Changes to Get subscription details `GET /api/v1/subscriptions/{subscription_id}` > Every recorded change to this operation, newest first. ## Timeline Changed in 9 of 54 revisions. - **2026-08-12** (v1) `4e013b4e4a8f`: 16 breaking - **2026-06-01** (v1) `07a61fe347a5`: 1 breaking, 1 warning - **2026-05-28** (v1) `ed86d893d43e`: 1 breaking, 2 info - **2026-05-18** (v1) `0cdc37620ffb`: 1 info - **2026-03-31** (v1) `ee465c53a423`: 2 breaking, 5 info - **2026-03-31** (v1) `560215310a09`: 1 breaking, 2 info - **2026-03-27** (v1) `de35c02bb0d2`: 2 breaking, 3 warning, 1 info - **2026-02-23** (v1) `e78cbe818dc6`: 2 info - **2025-07-09** (v1) `dece17f86f99`: 18 breaking, 10 warning, 166 info ## Changes - **2026-08-12** (v1) `4e013b4e4a8f`: 16 breaking - the response property `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became nullable for the status `200` - the response property `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became nullable for the status `200` - the response property `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became nullable for the status `200` - the response property `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became nullable for the status `200` - the response property `components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became nullable for the status `200` - the response property `components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became nullable for the status `200` - the response property `components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became nullable for the status `200` - the response property `components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became nullable for the status `200` - the response property `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became optional for the status `200` - the response property `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became optional for the status `200` - the response property `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became optional for the status `200` - the response property `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became optional for the status `200` - the response property `components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_cap` became optional for the status `200` - the response property `components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/TieredPricing]/tiers/items/flat_fee` became optional for the status `200` - the response property `components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_cap` became optional for the status `200` - the response property `components/items/fee/oneOf[#/components/schemas/UsageFee]/model/oneOf[#/components/schemas/VolumePricing]/tiers/items/flat_fee` became optional for the status `200` - **2026-06-01** (v1) `07a61fe347a5`: 1 breaking, 1 warning - removed the required property `entitlements/items/value/oneOf[#/components/schemas/MeteredEntitlementValue]/overage_behavior` from the response with the `200` status - removed the optional property `entitlements/items/value/oneOf[#/components/schemas/MeteredEntitlementValue]/warning_threshold_pct` from the response with the `200` status - **2026-05-28** (v1) `ed86d893d43e`: 1 breaking, 2 info - added `#/components/schemas/BooleanEntitlementValue, #/components/schemas/MeteredEntitlementValue` to the `entitlements/items/value` response property `oneOf` list for the response status `200` - added discriminator to `entitlements/items/value` response property for the response status `200` - removed `subschema #1, subschema #2` from the `entitlements/items/value` response property `oneOf` list for the response status `200` - **2026-05-18** (v1) `0cdc37620ffb`: 1 info - added the optional property `entitlements` to the response with the `200` status - **2026-03-31** (v1) `ee465c53a423`: 2 breaking, 5 info - the `applied_coupons/items/coupon/discount/oneOf[#/components/schemas/FixedDiscount]/amount` response's property format changed from `decimal` to no format for status `200` - the `applied_coupons/items/coupon/discount/oneOf[#/components/schemas/PercentageDiscount]/percentage` response's property format changed from `decimal` to no format for status `200` - response discriminator property name changed for `add_ons/items/fee` response property from `discriminator` to `type` for the response status `200` - response discriminator property name changed for `add_ons/items/fee/oneOf[#/components/schemas/UsageFee]/model` response property from `discriminator` to `type` for the response status `200` - response discriminator property name changed for `applied_coupons/items/coupon/discount` response property from `discriminator` to `type` for the response status `200` - response discriminator property name changed for `components/items/fee` response property from `discriminator` to `type` for the response status `200` - response discriminator property name changed for `components/items/fee/oneOf[#/components/schemas/UsageFee]/model` response property from `discriminator` to `type` for the response status `200` - **2026-03-31** (v1) `560215310a09`: 1 breaking, 2 info - added `#/components/schemas/OnlinePaymentMethodConfig, #/components/schemas/BankTransferPaymentMethodConfig, #/components/schemas/ExternalPaymentMethodConfig` to the `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` response property `oneOf` list for the response status `200` - added discriminator to `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` response property for the response status `200` - removed `subschema #1, subschema #2, subschema #3` from the `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/` response property `oneOf` list for the response status `200` - **2026-03-27** (v1) `de35c02bb0d2`: 2 breaking, 3 warning, 1 info - added `#/components/schemas/BankAccountId, subschema #1` to the `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/oneOf[subschema #2]/account_id` response property `oneOf` list for the response status `200` - the `payment_methods_config/oneOf[#/components/schemas/PaymentMethodsConfig]/oneOf[subschema #2]/account_id` response's property type changed from `string, null` to no type for status `200` - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `401` - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `404` - added the new `TOO_MANY_REQUESTS` enum value to the `code` response property for the response status `500` - added the non-success response with the status `429` - **2026-02-23** (v1) `e78cbe818dc6`: 2 info - added the optional property `add_ons/items/id` to the response with the `200` status - added the required property `add_ons/items/quantity` to the response with the `200` status - **2025-07-09** (v1) `dece17f86f99`: 18 breaking, 10 warning, 166 info - removed the media type `application/json` for the response with the status `401` - removed the media type `application/json` for the response with the status `500` - removed the required property `add_ons` from the response with the `200` status - removed the required property `applied_coupons` from the response with the `200` status - removed the required property `auto_advance_invoices` from the response with the `200` status - removed the required property `charge_automatically` from the response with the `200` status - removed the required property `components` from the response with the `200` status - removed the required property `created_at` from the response with the `200` status - removed the required property `current_period_start` from the response with the `200` status - removed the required property `mrr_cents` from the response with the `200` status - removed the required property `net_terms` from the response with the `200` status - removed the required property `period` from the response with the `200` status - removed the required property `plan_id` from the response with the `200` status - removed the required property `plan_name` from the response with the `200` status - removed the required property `plan_version` from the response with the `200` status - removed the required property `plan_version_id` from the response with the `200` status - removed the required property `start_date` from the response with the `200` status - removed the required property `status` from the response with the `200` status - removed the optional property `activated_at` from the response with the `200` status - removed the optional property `billing_start_date` from the response with the `200` status - removed the optional property `checkout_url` from the response with the `200` status - removed the optional property `current_period_end` from the response with the `200` status - removed the optional property `end_date` from the response with the `200` status - removed the optional property `entitlements` from the response with the `200` status - removed the optional property `invoice_memo` from the response with the `200` status - removed the optional property `payment_methods_config` from the response with the `200` status - removed the optional property `purchase_order` from the response with the `200` status - removed the optional property `trial_duration` from the response with the `200` status - the endpoint scheme security `api-key` was added to the API - the endpoint scheme security `bearer_auth` was removed from the API - api tag `subscription` added - api tag `Subscriptions` removed - for the `path` request parameter `subscription_id`, the format was generalized from `MeteroidId` to no format - removed the non-success response with the status `404` - removed the non-success response with the status `429` - removed the `AED` enum value from the `currency` response property for the response status `200` - removed the `AFN` enum value from the `currency` response property for the response status `200` - removed the `ALL` enum value from the `currency` response property for the response status `200` - removed the `AMD` enum value from the `currency` response property for the response status `200` - removed the `ANG` enum value from the `currency` response property for the response status `200` - …154 more --- [Operation](https://skmtc.dev/meteroid-oss/apis/meteroid/docs/api/v1/subscriptions/:subscription_id/get.md) - [API](https://skmtc.dev/meteroid-oss/apis/meteroid.md) - [Page](https://skmtc.dev/meteroid-oss/apis/meteroid/changes/api/v1/subscriptions/:subscription_id/get)