---
title: Subscription Versions
framework: App Store Connect API
role: collectionGroup
role_heading: API Collection
path: appstoreconnectapi/subscription-versions
---

# Subscription Versions

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

## Overview

Overview 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](appstoreconnectapi/post-v1-subscriptionversions.md)
- [Read subscription version information](appstoreconnectapi/get-v1-subscriptionversions-_id_.md)
- [Read the image for a subscription version](appstoreconnectapi/get-v1-subscriptionversions-_id_-image.md)
- [List images for a subscription version](appstoreconnectapi/get-v1-subscriptionversions-_id_-images.md)
- [List localizations for a subscription version](appstoreconnectapi/get-v1-subscriptionversions-_id_-localizations.md)
- [Read the image ID for a subscription version](appstoreconnectapi/get-v1-subscriptionversions-_id_-relationships-image.md)
- [List image IDs for a subscription version](appstoreconnectapi/get-v1-subscriptionversions-_id_-relationships-images.md)
- [List localization IDs for a subscription version](appstoreconnectapi/get-v1-subscriptionversions-_id_-relationships-localizations.md)
- [List versions for a subscription](appstoreconnectapi/get-v1-subscriptions-_id_-versions.md)
- [List version IDs for a subscription](appstoreconnectapi/get-v1-subscriptions-_id_-relationships-versions.md)

### Objects

- [SubscriptionVersion](appstoreconnectapi/subscriptionversion.md)
- [SubscriptionVersionCreateRequest](appstoreconnectapi/subscriptionversioncreaterequest.md)
- [SubscriptionVersionImageLinkageResponse](appstoreconnectapi/subscriptionversionimagelinkageresponse.md)
- [SubscriptionVersionImagesLinkagesResponse](appstoreconnectapi/subscriptionversionimageslinkagesresponse.md)
- [SubscriptionVersionLocalizationsLinkagesResponse](appstoreconnectapi/subscriptionversionlocalizationslinkagesresponse.md)
- [SubscriptionVersionResponse](appstoreconnectapi/subscriptionversionresponse.md)
- [SubscriptionVersionsLinkagesResponse](appstoreconnectapi/subscriptionversionslinkagesresponse.md)
- [SubscriptionVersionsResponse](appstoreconnectapi/subscriptionversionsresponse.md)

## See Also

### Managing Auto-Renewable Subscriptions

- [Managing auto-renewable subscriptions](appstoreconnectapi/managing-auto-renewable-subscriptions.md)
- [Working with subscription versions](appstoreconnectapi/working-with-subscription-versions.md)
- [Configuring subscription prices across territories](appstoreconnectapi/configuring-subscription-prices-across-territories.md)
- [Querying adjusted subscription price equalizations](appstoreconnectapi/querying-adjusted-subscription-price-equalizations.md)
- [Subscriptions](appstoreconnectapi/subscriptions.md)
- [Subscription Localizations](appstoreconnectapi/subscription-localizations.md)
- [Subscription localizations (v1)](appstoreconnectapi/subscription-localizations-v1.md)
- [Subscription price points and subscription prices](appstoreconnectapi/subscription-price-points-and-subscription-prices.md)
- [Subscription images](appstoreconnectapi/subscription-images.md)
- [Subscription images (v1)](appstoreconnectapi/subscription-images-v1.md)
- [Subscription availability](appstoreconnectapi/subscription-availability.md)
- [Subscription plan availability](appstoreconnectapi/subscription-plan-availability.md)
- [Billing Grace Periods](appstoreconnectapi/billing-grace-periods.md)