---
title: "Changes to Change subscription"
method: POST
path: "/openmeter/subscriptions/{subscriptionId}/change"
---

# Changes to Change subscription

`POST /openmeter/subscriptions/{subscriptionId}/change`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 107 revisions.

- **2026-09-21** (v3) `159bfd1e78cf`: 1 breaking, 1 warning, 4 info
- **2026-09-10** (v3) `c86a4709f542`: 1 info
- **2026-09-04** (v3) `3202e8c27652`: 2 info
- **2026-08-25** (v3) `bd7fb1027684`: 2 breaking, 2 info
- **2026-08-18** (v3) `327f2080730f`: 20 info
- **2026-08-13** (v3) `1abd3e0f448b`: 7 info
- **2026-06-12** (v3) `3ecbdfd707eb`: 3 info
- **2026-06-09** (v3) `64826b7e8711`: 3 info
- **2026-05-11** (v3) `9d0042cb3815`: 3 warning

## Changes

- **2026-09-21** (v3) `159bfd1e78cf`: 1 breaking, 1 warning, 4 info
  - added `#/components/schemas/TaxCodeConfig` to the `custom_plan/allOf[#/components/schemas/BillingSubscriptionCustomPlan]/phases/items/rate_cards/items/tax_config` request property `allOf` list
  - removed `#/components/schemas/BillingRateCardTaxConfig` from the `custom_plan/allOf[#/components/schemas/BillingSubscriptionCustomPlan]/phases/items/rate_cards/items/tax_config` request property `allOf` list
  - added `#/components/schemas/TaxCodeConfig` to the `current/allOf[#/components/schemas/BillingSubscription]/phases/items/items/items/rate_card/allOf[#/components/schemas/BillingRateCard]/tax_config` response property `allOf` list for the response status `200`
  - added `#/components/schemas/TaxCodeConfig` to the `next/allOf[#/components/schemas/BillingSubscription]/phases/items/items/items/rate_card/allOf[#/components/schemas/BillingRateCard]/tax_config` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/BillingRateCardTaxConfig` from the `current/allOf[#/components/schemas/BillingSubscription]/phases/items/items/items/rate_card/allOf[#/components/schemas/BillingRateCard]/tax_config` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/BillingRateCardTaxConfig` from the `next/allOf[#/components/schemas/BillingSubscription]/phases/items/items/items/rate_card/allOf[#/components/schemas/BillingRateCard]/tax_config` response property `allOf` list for the response status `200`
- **2026-09-10** (v3) `c86a4709f542`: 1 info
  - added the new optional request property `starting_phase`
- **2026-09-04** (v3) `3202e8c27652`: 2 info
  - added the new optional request property `custom_plan`
  - the request property `plan` became optional
- **2026-08-25** (v3) `bd7fb1027684`: 2 breaking, 2 info
  - added `#/components/schemas/CurrencyCode, #/components/schemas/BillingCurrencyCodeCustom` to the `current/allOf[#/components/schemas/BillingSubscription]/phases/items/items/items/rate_card/allOf[#/components/schemas/BillingRateCard]/currency/allOf[#/components/schemas/BillingCurrencyCode]/` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/CurrencyCode, #/components/schemas/BillingCurrencyCodeCustom` to the `next/allOf[#/components/schemas/BillingSubscription]/phases/items/items/items/rate_card/allOf[#/components/schemas/BillingRateCard]/currency/allOf[#/components/schemas/BillingCurrencyCode]/` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/CurrencyCode, #/components/schemas/BillingCurrencyCodeCustom` from the `current/allOf[#/components/schemas/BillingSubscription]/phases/items/items/items/rate_card/allOf[#/components/schemas/BillingRateCard]/currency/allOf[#/components/schemas/BillingCurrencyCode]/` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/CurrencyCode, #/components/schemas/BillingCurrencyCodeCustom` from the `next/allOf[#/components/schemas/BillingSubscription]/phases/items/items/items/rate_card/allOf[#/components/schemas/BillingRateCard]/currency/allOf[#/components/schemas/BillingCurrencyCode]/` response property `anyOf` list for the response status `200`
- **2026-08-18** (v3) `327f2080730f`: 20 info
  - added the optional property `current/allOf[#/components/schemas/BillingSubscription]/active_to` to the response with the `200` status
  - added the optional property `current/allOf[#/components/schemas/BillingSubscription]/current_period` to the response with the `200` status
  - added the optional property `current/allOf[#/components/schemas/BillingSubscription]/description` to the response with the `200` status
  - added the optional property `current/allOf[#/components/schemas/BillingSubscription]/plan` to the response with the `200` status
  - added the optional property `current/allOf[#/components/schemas/BillingSubscription]/pro_rating_config` to the response with the `200` status
  - added the optional property `next/allOf[#/components/schemas/BillingSubscription]/active_to` to the response with the `200` status
  - added the optional property `next/allOf[#/components/schemas/BillingSubscription]/current_period` to the response with the `200` status
  - added the optional property `next/allOf[#/components/schemas/BillingSubscription]/description` to the response with the `200` status
  - added the optional property `next/allOf[#/components/schemas/BillingSubscription]/plan` to the response with the `200` status
  - added the optional property `next/allOf[#/components/schemas/BillingSubscription]/pro_rating_config` to the response with the `200` status
  - response property `current/allOf[#/components/schemas/BillingSubscription]/plan_id` deprecated
  - response property `next/allOf[#/components/schemas/BillingSubscription]/plan_id` deprecated
  - added the required property `current/allOf[#/components/schemas/BillingSubscription]/active_from` to the response with the `200` status
  - added the required property `current/allOf[#/components/schemas/BillingSubscription]/billing_cadence` to the response with the `200` status
  - added the required property `current/allOf[#/components/schemas/BillingSubscription]/name` to the response with the `200` status
  - added the required property `current/allOf[#/components/schemas/BillingSubscription]/phases` to the response with the `200` status
  - added the required property `next/allOf[#/components/schemas/BillingSubscription]/active_from` to the response with the `200` status
  - added the required property `next/allOf[#/components/schemas/BillingSubscription]/billing_cadence` to the response with the `200` status
  - added the required property `next/allOf[#/components/schemas/BillingSubscription]/name` to the response with the `200` status
  - added the required property `next/allOf[#/components/schemas/BillingSubscription]/phases` to the response with the `200` status
- **2026-08-13** (v3) `1abd3e0f448b`: 7 info
  - added the new optional request property `cost_basis_mode`
  - added the required property `current/allOf[#/components/schemas/BillingSubscription]/cost_basis_mode` to the response with the `200` status
  - added the required property `current/allOf[#/components/schemas/BillingSubscription]/cost_basis_pins` to the response with the `200` status
  - added the required property `current/allOf[#/components/schemas/BillingSubscription]/invoice_currency` to the response with the `200` status
  - added the required property `next/allOf[#/components/schemas/BillingSubscription]/cost_basis_mode` to the response with the `200` status
  - added the required property `next/allOf[#/components/schemas/BillingSubscription]/cost_basis_pins` to the response with the `200` status
  - added the required property `next/allOf[#/components/schemas/BillingSubscription]/invoice_currency` to the response with the `200` status
- **2026-06-12** (v3) `3ecbdfd707eb`: 3 info
  - the `settlement_mode` request property default value `credit_then_invoice` was removed
  - the `settlement_mode` response's property default value `credit_then_invoice` was removed for the status `200`
  - the `settlement_mode` response's property default value `credit_then_invoice` was removed for the status `200`
- **2026-06-09** (v3) `64826b7e8711`: 3 info
  - added the new optional request property `settlement_mode`
  - added the optional property `current/allOf[#/components/schemas/BillingSubscription]/settlement_mode` to the response with the `200` status
  - added the optional property `next/allOf[#/components/schemas/BillingSubscription]/settlement_mode` to the response with the `200` status
- **2026-05-11** (v3) `9d0042cb3815`: 3 warning
  - removed the request property `settlement_mode`
  - removed the optional property `current/allOf[#/components/schemas/BillingSubscription]/settlement_mode` from the response with the `200` status
  - removed the optional property `next/allOf[#/components/schemas/BillingSubscription]/settlement_mode` from the response with the `200` status

---

[Operation](https://skmtc.dev/openmeterio/apis/openmeter-api/docs/openmeter/subscriptions/:subscriptionId/change/post.md) · [API](https://skmtc.dev/openmeterio/apis/openmeter-api.md) · [Page](https://skmtc.dev/openmeterio/apis/openmeter-api/changes/openmeter/subscriptions/:subscriptionId/change/post)