# Subscriptions Create, modify, and delete auto-renewable subscriptions for your app. ## Topics ### Configuring Subscription Prices [Configuring subscription prices across territories](/documentation/AppStoreConnectAPI/configuring-subscription-prices-across-territories) Set plan types and equalized prices for an auto-renewable subscription with the App Store Connect API. ### Creating and managing subscriptions [`POST /v1/subscriptions`](/documentation/AppStoreConnectAPI/POST-v1-subscriptions) Create an auto-renewable subscription for your app. [`GET /v1/subscriptions/{id}`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_) Get information about a specific auto-renewable subscription. [`PATCH /v1/subscriptions/{id}`](/documentation/AppStoreConnectAPI/PATCH-v1-subscriptions-_id_) Update a specific auto-renewable subscription. [`DELETE /v1/subscriptions/{id}`](/documentation/AppStoreConnectAPI/DELETE-v1-subscriptions-_id_) Delete a specific auto-renewable subscription that you configured for an app. ### Getting subscription localizations [`GET /v1/subscriptions/{id}/subscriptionLocalizations`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-subscriptionLocalizations) Get a list of the subscription localizations for a specific auto-renewable subscription. [`GET /v1/subscriptions/{id}/relationships/subscriptionLocalizations`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-relationships-subscriptionLocalizations) ### Getting introductory offers [`GET /v1/subscriptions/{id}/introductoryOffers`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-introductoryOffers) Get a list of introductory offers for a specific auto-renewable subscription. [`GET /v1/subscriptions/{id}/relationships/introductoryOffers`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-relationships-introductoryOffers) Get a list of resource IDs representing introductory offers for an auto-renewable subscription. [`DELETE /v1/subscriptions/{id}/relationships/introductoryOffers`](/documentation/AppStoreConnectAPI/DELETE-v1-subscriptions-_id_-relationships-introductoryOffers) Delete a specific introductory offer for an auto-renewable subscription. ### Getting promotional offers [`GET /v1/subscriptions/{id}/promotionalOffers`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-promotionalOffers) Get a list of promotional offers for a specific auto-renewable subscription. [`GET /v1/subscriptions/{id}/relationships/promotionalOffers`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-relationships-promotionalOffers) ### Getting offer codes [`GET /v1/subscriptions/{id}/offerCodes`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-offerCodes) Get a list of subscription offer codes for a specific auto-renewable subscription. [`GET /v1/subscriptions/{id}/relationships/offerCodes`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-relationships-offerCodes) ### Getting win-back offers [`GET /v1/subscriptions/{id}/winBackOffers`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-winBackOffers) The data structure that represents a get-v1-subscriptions-{id}-win back offers resource. [`GET /v1/subscriptions/{id}/relationships/winBackOffers`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-relationships-winBackOffers) ### Getting the promoted purchase [`GET /v1/subscriptions/{id}/promotedPurchase`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-promotedPurchase) Get details about the promoted purchase of an auto-renewable subscription. [`GET /v1/subscriptions/{id}/relationships/promotedPurchase`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-relationships-promotedPurchase) ### Getting price points and prices [`GET /v1/subscriptions/{id}/pricePoints`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-pricePoints) Get a list of price points for an auto-renewable subscription by territory. [`GET /v1/subscriptions/{id}/relationships/pricePoints`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-relationships-pricePoints) [`GET /v1/subscriptions/{id}/prices`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-prices) Get a list of prices for an auto-renewable subscription, by territory. [`GET /v1/subscriptions/{id}/relationships/prices`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-relationships-prices) Get a list of resource IDs representing subscription prices for an auto-renewable subscription. [`DELETE /v1/subscriptions/{id}/relationships/prices`](/documentation/AppStoreConnectAPI/DELETE-v1-subscriptions-_id_-relationships-prices) Delete a scheduled subscription price change for an auto-renewable subscription. ### Getting subscription availability [`GET /v1/subscriptions/{id}/subscriptionAvailability`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-subscriptionAvailability) Get information about the territory availability for a subscription. [`GET /v1/subscriptions/{id}/relationships/subscriptionAvailability`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-relationships-subscriptionAvailability) [`GET /v1/subscriptions/{id}/planAvailabilities`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-planAvailabilities) List all plan availabilities for a specific auto-renewable subscription. [`GET /v1/subscriptions/{id}/relationships/planAvailabilities`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-relationships-planAvailabilities) Get a list of plan availability resource IDs for a specific auto-renewable subscription. ### Getting the App Store review screenshot [`GET /v1/subscriptions/{id}/appStoreReviewScreenshot`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-appStoreReviewScreenshot) Get information about review screenshot for a specific auto-renewable subscription. [`GET /v1/subscriptions/{id}/relationships/appStoreReviewScreenshot`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-relationships-appStoreReviewScreenshot) ### Objects and data types [`SubscriptionCreateRequest`](/documentation/AppStoreConnectAPI/SubscriptionCreateRequest) The request body you use to create a subscription. [`SubscriptionUpdateRequest`](/documentation/AppStoreConnectAPI/SubscriptionUpdateRequest) The request body you use to update a subscription update request. [`SubscriptionResponse`](/documentation/AppStoreConnectAPI/SubscriptionResponse) The response body for endpoints that create, read, or modify a single auto-renewable subscription. [`SubscriptionsResponse`](/documentation/AppStoreConnectAPI/SubscriptionsResponse) The response body for endpoints that list auto-renewable subscriptions in a subscription group. [`Subscription`](/documentation/AppStoreConnectAPI/Subscription) An auto-renewable subscription product offered within an app, with configurable pricing, duration, and promotional offers. [`SubscriptionIntroductoryOffersResponse`](/documentation/AppStoreConnectAPI/SubscriptionIntroductoryOffersResponse) The response body for endpoints that list introductory offers for a subscription. [`SubscriptionIntroductoryOffer`](/documentation/AppStoreConnectAPI/SubscriptionIntroductoryOffer) A discounted price or free trial period offered to new subscribers of an auto-renewable subscription. [`SubscriptionIntroductoryOffersLinkagesRequest`](/documentation/AppStoreConnectAPI/SubscriptionIntroductoryOffersLinkagesRequest) The request body for updating the list of introductory offers linked to a subscription. [`SubscriptionIntroductoryOffersLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionIntroductoryOffersLinkagesResponse) A response containing the resource identifiers of introductory offers linked to a subscription. [`SubscriptionOfferCodeResponse`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodeResponse) The response body for endpoints that create, read, or modify a single subscription offer code. [`SubscriptionOfferCodesResponse`](/documentation/AppStoreConnectAPI/SubscriptionOfferCodesResponse) The response body for endpoints that list offer codes for a subscription. [`SubscriptionOfferCode`](/documentation/AppStoreConnectAPI/SubscriptionOfferCode) A promotional code that gives customers a discounted or free subscription for a specified duration and eligibility group. [`PromotedPurchaseResponse`](/documentation/AppStoreConnectAPI/PromotedPurchaseResponse) The response body for endpoints that read or modify a promoted in-app purchase or subscription. [`PromotedPurchase`](/documentation/AppStoreConnectAPI/PromotedPurchase) An in-app purchase or subscription configured to appear on the app’s App Store product page. [`SubscriptionPricePointsResponse`](/documentation/AppStoreConnectAPI/SubscriptionPricePointsResponse) The response body for endpoints that list available price points for a subscription. [`SubscriptionPricesResponse`](/documentation/AppStoreConnectAPI/SubscriptionPricesResponse) The response body for endpoints that list scheduled prices for a subscription. [`SubscriptionPrice`](/documentation/AppStoreConnectAPI/SubscriptionPrice) A configured price for an auto-renewable subscription in a specific App Store territory. [`SubscriptionPricesLinkagesRequest`](/documentation/AppStoreConnectAPI/SubscriptionPricesLinkagesRequest) The request body for updating the list of prices linked to a subscription. [`SubscriptionPricesLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionPricesLinkagesResponse) A response containing the resource identifiers of prices linked to a subscription. [`SubscriptionLocalizationResponse`](/documentation/AppStoreConnectAPI/SubscriptionLocalizationResponse) The response body for endpoints that create, read, or modify a single subscription localization. [`SubscriptionLocalizationsResponse`](/documentation/AppStoreConnectAPI/SubscriptionLocalizationsResponse) The response body for endpoints that list localizations for a subscription. [`SubscriptionLocalization`](/documentation/AppStoreConnectAPI/SubscriptionLocalization) The localized display name and description for an auto-renewable subscription shown to customers on the App Store. [`SubscriptionWinBackOffersLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionWinBackOffersLinkagesResponse) [`SubscriptionAppStoreReviewScreenshotLinkageResponse`](/documentation/AppStoreConnectAPI/SubscriptionAppStoreReviewScreenshotLinkageResponse) [`SubscriptionPricePointEqualizationsLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionPricePointEqualizationsLinkagesResponse) [`SubscriptionPricePointsLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionPricePointsLinkagesResponse) [`SubscriptionPromotedPurchaseLinkageResponse`](/documentation/AppStoreConnectAPI/SubscriptionPromotedPurchaseLinkageResponse) [`SubscriptionPromotionalOfferPricesLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionPromotionalOfferPricesLinkagesResponse) [`SubscriptionPromotionalOffersLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionPromotionalOffersLinkagesResponse) [`SubscriptionSubscriptionAvailabilityLinkageResponse`](/documentation/AppStoreConnectAPI/SubscriptionSubscriptionAvailabilityLinkageResponse) [`SubscriptionSubscriptionLocalizationsLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionSubscriptionLocalizationsLinkagesResponse) --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)