<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/subscription-versions",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Subscription Versions"
}
-->

# Subscription Versions

Create and read draft versions of an auto-renewable subscription, with their localized metadata and review images.

## Discussion

Each subscription has a version, which is the container for the localizations and images related to that subscription. Use the subscription version for submitting to review.

## Topics

### Endpoints

[`Create a subscription version`](/documentation/AppStoreConnectAPI/POST-v1-subscriptionVersions)

Create a draft version of an auto-renewable subscription, capturing its current localized metadata and review images for App Review submission.

[`Read subscription version information`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionVersions-_id_)

Get information about a specific draft version of an auto-renewable subscription.

[`Read the image for a subscription version`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionVersions-_id_-image)

Get the review image attached to a draft version of an auto-renewable subscription.

[`List images for a subscription version`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionVersions-_id_-images)

List the review images attached to a draft version of an auto-renewable subscription.

[`List localizations for a subscription version`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionVersions-_id_-localizations)

List the localized display names and descriptions captured in a draft version of an auto-renewable subscription.

[`Read the image ID for a subscription version`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionVersions-_id_-relationships-image)

Get the related resource ID for the review image attached to a draft version of an auto-renewable subscription.

[`List image IDs for a subscription version`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionVersions-_id_-relationships-images)

Get the related resource IDs for the review images attached to a draft version of an auto-renewable subscription.

[`List localization IDs for a subscription version`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionVersions-_id_-relationships-localizations)

Get the related resource IDs for the localizations captured in a draft version of an auto-renewable subscription.

[`List versions for a subscription`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-versions)

List the draft versions of an auto-renewable subscription.

[`List version IDs for a subscription`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-relationships-versions)

Get the related resource IDs for the draft versions of an auto-renewable subscription.

### Objects

[`object SubscriptionVersion`](/documentation/AppStoreConnectAPI/SubscriptionVersion)

A draft version of an auto-renewable subscription that captures its localized metadata and review images for App Review submission.

[`object SubscriptionVersionCreateRequest`](/documentation/AppStoreConnectAPI/SubscriptionVersionCreateRequest)

The request body you use to create a draft version of an auto-renewable subscription.

[`object SubscriptionVersionImageLinkageResponse`](/documentation/AppStoreConnectAPI/SubscriptionVersionImageLinkageResponse)

A response with the related resource identifier for a subscription version’s image.

[`object SubscriptionVersionImagesLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionVersionImagesLinkagesResponse)

A response with the related resource identifiers for a subscription version’s images.

[`object SubscriptionVersionLocalizationsLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionVersionLocalizationsLinkagesResponse)

A response with the related resource identifiers for a subscription version’s localizations.

[`object SubscriptionVersionResponse`](/documentation/AppStoreConnectAPI/SubscriptionVersionResponse)

The response body for endpoints that create or read a subscription version.

[`object SubscriptionVersionsLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionVersionsLinkagesResponse)

A response with the related resource identifiers for the versions of an auto-renewable subscription.

[`object SubscriptionVersionsResponse`](/documentation/AppStoreConnectAPI/SubscriptionVersionsResponse)

The response body for endpoints that list subscription versions.


---

Copyright &copy; 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)