---
title: "Changes to Create a price transition for a subscription item"
method: POST
path: "/billing/subscription_items/{subscription_item_id}/price_transition"
---

# Changes to Create a price transition for a subscription item

`POST /billing/subscription_items/{subscription_item_id}/price_transition`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 49 revisions.

- **2026-06-26** (2025-11-10) `b45c56a4eed9`: 4 info
- **2026-06-04** (2025-11-10) `4db0b9e2d5e6`: 5 info
- **2026-03-19** (2025-11-10) `b1a5498e4465`: 48 breaking, 8 info
- **2026-02-21** (2025-11-10) `6b6bf4e8c298`: 1 info
- **2026-02-12** (2025-11-10) `33ad373c8b42`: 1 info
- **2026-01-26** (2025-11-10) `567a99685f20`: 1 info

## Changes

- **2026-06-26** (2025-11-10) `b45c56a4eed9`: 4 info
  - added `#/components/schemas/CommercePayerResponse-2` to the `subscription_item/payer` response property `allOf` list for the response status `200`
  - added `#/components/schemas/CommercePlan-2` to the `subscription_item/plan` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/schemas-CommercePayerResponse` from the `subscription_item/payer` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/schemas-CommercePlan` from the `subscription_item/plan` response property `allOf` list for the response status `200`
- **2026-06-04** (2025-11-10) `4db0b9e2d5e6`: 5 info
  - added the optional property `subscription_item/next_invoice/allOf[#/components/schemas/CommerceSubscriptionItemNextPaymentResponse]/per_unit_totals` to the response with the `200` status
  - added the optional property `subscription_item/next_invoice/allOf[#/components/schemas/CommerceSubscriptionItemNextPaymentResponse]/totals` to the response with the `200` status
  - added the optional property `subscription_item/next_payment/allOf[#/components/schemas/CommerceSubscriptionItemNextPaymentResponse]/per_unit_totals` to the response with the `200` status
  - added the optional property `subscription_item/next_payment/allOf[#/components/schemas/CommerceSubscriptionItemNextPaymentResponse]/totals` to the response with the `200` status
  - added the required property `transition/previous_price/supported_billing_periods` to the response with the `200` status
- **2026-03-19** (2025-11-10) `b1a5498e4465`: 48 breaking, 8 info
  - the response property `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_fee` became nullable for the status `200`
  - the response property `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_monthly_fee` became nullable for the status `200`
  - the response property `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/fee` became nullable for the status `200`
  - the response property `transition/previous_plan/annual_fee` became nullable for the status `200`
  - the response property `transition/previous_plan/annual_monthly_fee` became nullable for the status `200`
  - the response property `transition/previous_plan/fee` became nullable for the status `200`
  - the response property `transition/previous_price/annual_monthly_fee` became nullable for the status `200`
  - the response property `transition/previous_price/fee` became nullable for the status `200`
  - the `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_fee` response's property type changed from `object` to no type for status `200`
  - the `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_monthly_fee` response's property type changed from `object` to no type for status `200`
  - the `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/fee` response's property type changed from `object` to no type for status `200`
  - the `transition/previous_plan/annual_fee` response's property type changed from `object` to no type for status `200`
  - the `transition/previous_plan/annual_monthly_fee` response's property type changed from `object` to no type for status `200`
  - the `transition/previous_plan/fee` response's property type changed from `object` to no type for status `200`
  - the `transition/previous_price/annual_monthly_fee` response's property type changed from `object` to no type for status `200`
  - the `transition/previous_price/fee` response's property type changed from `object` to no type for status `200`
  - removed the required property `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_fee/amount` from the response with the `200` status
  - removed the required property `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_fee/amount_formatted` from the response with the `200` status
  - removed the required property `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_fee/currency` from the response with the `200` status
  - removed the required property `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_fee/currency_symbol` from the response with the `200` status
  - removed the required property `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_monthly_fee/amount` from the response with the `200` status
  - removed the required property `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_monthly_fee/amount_formatted` from the response with the `200` status
  - removed the required property `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_monthly_fee/currency` from the response with the `200` status
  - removed the required property `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/annual_monthly_fee/currency_symbol` from the response with the `200` status
  - removed the required property `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/fee/amount` from the response with the `200` status
  - removed the required property `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/fee/amount_formatted` from the response with the `200` status
  - removed the required property `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/fee/currency` from the response with the `200` status
  - removed the required property `subscription_item/plan/allOf[#/components/schemas/schemas-CommercePlan]/fee/currency_symbol` from the response with the `200` status
  - removed the required property `transition/previous_plan/annual_fee/amount` from the response with the `200` status
  - removed the required property `transition/previous_plan/annual_fee/amount_formatted` from the response with the `200` status
  - removed the required property `transition/previous_plan/annual_fee/currency` from the response with the `200` status
  - removed the required property `transition/previous_plan/annual_fee/currency_symbol` from the response with the `200` status
  - removed the required property `transition/previous_plan/annual_monthly_fee/amount` from the response with the `200` status
  - removed the required property `transition/previous_plan/annual_monthly_fee/amount_formatted` from the response with the `200` status
  - removed the required property `transition/previous_plan/annual_monthly_fee/currency` from the response with the `200` status
  - removed the required property `transition/previous_plan/annual_monthly_fee/currency_symbol` from the response with the `200` status
  - removed the required property `transition/previous_plan/fee/amount` from the response with the `200` status
  - removed the required property `transition/previous_plan/fee/amount_formatted` from the response with the `200` status
  - removed the required property `transition/previous_plan/fee/currency` from the response with the `200` status
  - removed the required property `transition/previous_plan/fee/currency_symbol` from the response with the `200` status
  - …16 more
- **2026-02-21** (2025-11-10) `6b6bf4e8c298`: 1 info
  - added the required property `transition/previous_price/is_default` to the response with the `200` status
- **2026-02-12** (2025-11-10) `33ad373c8b42`: 1 info
  - added the optional property `subscription_item/payer/allOf[#/components/schemas/schemas-CommercePayerResponse]/credits_balance` to the response with the `200` status
- **2026-01-26** (2025-11-10) `567a99685f20`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/clerk/apis/clerk-backend-api/docs/billing/subscription_items/:subscription_item_id/price_transition/post.md) - [API](https://skmtc.dev/clerk/apis/clerk-backend-api.md) - [Page](https://skmtc.dev/clerk/apis/clerk-backend-api/changes/billing/subscription_items/:subscription_item_id/price_transition/post)