Billing

Create a price transition for a subscription item

Changed on

Creates a price transition for the specified subscription item. This may create an upcoming subscription item or activate immediately depending on plan and payer rules.

post/billing/subscription_items/{subscription_item_id}/price_transition

Request

  • Base URL: https://api.clerk.com/v1
  • URL: https://api.clerk.com/v1/billing/subscription_items/{subscription_item_id}/price_transition
  • Auth: HTTP bearer

Path parameters

subscription_item_idstring required

The ID of the subscription item to transition

Request body

from_price_idstring required

The current price ID of the subscription item.

to_price_idstring required

The target price ID to transition to.

Response

A commerce price transition.

object'commerce_price_transition' required

String representing the object's type. Objects of the same type share the same value.

Changes

  • 2025-11-10b45c56a4eed9Revision changes
    • info

      added to the / response property allOf list for the response status

    • info

      added to the / response property allOf list for the response status

    • info

      removed from the / response property allOf list for the response status

    • info

      removed from the / response property allOf list for the response status

  • 2025-11-104db0b9e2d5e6Revision changes
    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the optional property ////// to the response with the status

    • info

      added the required property // to the response with the status