---
title: Change Subscription Price
framework: advancedcommerceapi
role: symbol
role_heading: Web Service Endpoint
path: advancedcommerceapi/change-subscription-price
---

# Change Subscription Price

Increase or decrease the price of an auto-renewable subscription, a bundle, or individual items within a subscription at the next renewal.

## URL

POST https://api.storekit.itunes.apple.com/advancedCommerce/v1/subscription/changePrice/{transactionId}

## Sandbox URL

POST https://api.storekit-sandbox.itunes.apple.com/advancedCommerce/v1/subscription/changePrice/{transactionId}

## Path Parameters

transactionId: A transaction identifier of the auto-renewable subscription that is subject to the price change. Use the subscription’s original transaction ID or any subsequent transaction ID of a transaction related to the subscription.

## Response Codes

200 OK: Success 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 : 500 Internal Server Error:

## Mentioned in

Handling subscription price changes Authorizing API requests from your server Advanced Commerce API changelog Identifying rate limits for Advanced Commerce APIs

## Discussion

Discussion Call this endpoint when you change the price of a subscription or any bundle or item within it. For information about the customer communication, see Handling subscription price changes. Only active subscriptions that aren’t in a billing retry state are eligible for price changes. When you call this endpoint, the price change takes effect at the next subscription renewal. Call the endpoint no later than 24 hours before the renewal date to have it take effect at the renewal. For information about providing prices, see Specifying prices for Advanced Commerce SKUs. Example request and response In the following request: The subscription includes multiple items, and only one item has a price increase to USD 12.99. The price increase takes effect at the next subscription renewal. The decoded signed transaction shows price in the current period, before the increase. The decoded signed renewal information shows the increased price, which takes effect at the next renewal period if consented to. The item has a dependent SKU, which will be cancelled if the price increase is not agreed to. In this example, the price increase has been communicated, so the status is marked as pending.

## HTTP Body

The request body that contains the details of the price change.

## See Also

### Subscription price change from the server

- [SubscriptionPriceChangeRequest](advancedcommerceapi/subscriptionpricechangerequest.md)
- [SubscriptionPriceChangeResponse](advancedcommerceapi/subscriptionpricechangeresponse.md)