# App Store Versions Manage versions of your app that are available in App Store. ## Discussion The `appStoreVersions` resource represents the information related to an App Store version of your app. Using this resource, you can: - Create, modify, or delete a version for your app. - Read key details for your version, including its App Store state. - Specify whether to release the version manually or automatically. - Modify attributes such as your app’s copyright information. For more information about versions, see [Create a new version](https://developer.apple.com/help/app-store-connect/update-your-app/create-a-new-version). ## Topics ### Getting App Store Versions [`List all app store versions for an app`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-appStoreVersions) Get a list of all App Store versions of an app across all platforms. [`Read app store version information`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_) Get information for a specific App Store version. ### Getting App Store Version Experiments [`List all experiments for an app store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-appStoreVersionExperimentsV2) Get a list of all experiments for an App Store version of an app across all platforms. [`List all experiment ids for an app store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-relationships-appStoreVersionExperimentsV2) Get a list of all experiments IDs for an App Store version across all platforms. [`List all experiments for an app store version v1`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-appStoreVersionExperiments) Get a list of all experiments for an App Store version of an app across all platforms. [`List all experiments ids for an app store version v1`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-relationships-appStoreVersionExperiments) Get a list of all experiments IDs for an App Store version of an app across all platforms. ### Creating and Modifying App Store Versions [`Create an app store version`](/documentation/AppStoreConnectAPI/POST-v1-appStoreVersions) Add a new App Store version or platform to an app. [`Modify an app store version`](/documentation/AppStoreConnectAPI/PATCH-v1-appStoreVersions-_id_) Update the App Store version for a specific app. [`Delete an app store version`](/documentation/AppStoreConnectAPI/DELETE-v1-appStoreVersions-_id_) Delete an app store version that is associated with an app. ### Attaching a Build to a Version [`Read the build information of an app store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-build) Get the build that is attached to a specific App Store version. [`Get the build id for an app store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-relationships-build) Get the ID of the build that is attached to a specific App Store version. [`Modify the build for an app store version`](/documentation/AppStoreConnectAPI/PATCH-v1-appStoreVersions-_id_-relationships-build) Change the build that is attached to a specific App Store version. ### Attaching a Default App Clip Experience to a Version [`Get the default app clip experience for an app store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-appClipDefaultExperience) Get the default App Clip experience for an App Store version of your app. [`Get the default app clip experiences resource id for an app store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-relationships-appClipDefaultExperience) Get the ID of an app’s related default App Clip experience. [`Modify the default app clip experience of an app store version`](/documentation/AppStoreConnectAPI/PATCH-v1-appStoreVersions-_id_-relationships-appClipDefaultExperience) Update the relationship between an App Store version and a default App Clip experience. ### Reading Localization Information [`List all app store version localizations for an app store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-appStoreVersionLocalizations) Get a list of localized, version-level information about an app, for all locales. [`List App Store version localization IDs for an App Store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-relationships-appStoreVersionLocalizations) ### Reading Release and Review Information [`Read the app store version submission information of an app store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-appStoreVersionSubmission) Get the App Review submission for a specific App Store version. [`Get the App Store version submission ID for an App Store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-relationships-appStoreVersionSubmission) [`Read the app store review details resource information of an app store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-appStoreReviewDetail) Get the details you provide to App Review so they can test your app. [`Get the App Store review detail ID for an App Store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-relationships-appStoreReviewDetail) [`Read the app store version phased release information of an app store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-appStoreVersionPhasedRelease) Read the phased release status and configuration for a version with phased release enabled. [`Get the phased release ID for an App Store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-relationships-appStoreVersionPhasedRelease) ### Reading Declarations [`Read the routing app coverage information of an app store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-routingAppCoverage) Get the routing app coverage file that is associated with a specific App Store version [`Get the routing app coverage ID for an App Store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-relationships-routingAppCoverage) ### Getting Customer Reviews [`List all customer reviews for an app store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-customerReviews) Get a list of customer reviews for a specific version of your app. [`List customer review IDs for an App Store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-relationships-customerReviews) ### Getting Game Center app versions [`Read game center app version information of an app store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-gameCenterAppVersion) Get the status of Game Center enablement for an App Store version. [`Get the Game Center app version ID for an App Store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-relationships-gameCenterAppVersion) ### Reading Distribution Package Information [`Read an app store version’s alternative distribution package`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-alternativeDistributionPackage) Read the alternative distribution package for a specific App Store version. [`Get the alternative distribution package ID for an App Store version`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-relationships-alternativeDistributionPackage) ### Objects and Data Types [`AppStoreVersionUpdateRequest`](/documentation/AppStoreConnectAPI/AppStoreVersionUpdateRequest) The request body you use to update an App Store Version. [`AgeRatingDeclaration`](/documentation/AppStoreConnectAPI/AgeRatingDeclaration) A set of content descriptors for your app that App Store Connect uses to assign an age rating. [`AppStoreVersion`](/documentation/AppStoreConnectAPI/AppStoreVersion) The data structure that represent an App Store Versions resource. [`AppStoreVersionResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionResponse) The response body for endpoints that create, read, or modify an App Store version. [`AppStoreVersionsResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionsResponse) The response body for endpoints that list App Store versions for an app. [`AppStoreVersionCreateRequest`](/documentation/AppStoreConnectAPI/AppStoreVersionCreateRequest) The request body you use to create an App Store Version. [`AppStoreVersionBuildLinkageRequest`](/documentation/AppStoreConnectAPI/AppStoreVersionBuildLinkageRequest) The request body you use to attach a build to an App Store version. [`AppStoreVersionBuildLinkageResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionBuildLinkageResponse) A response body that contains the ID of a single related resource. [`AppStoreVersionAppClipDefaultExperienceLinkageRequest`](/documentation/AppStoreConnectAPI/AppStoreVersionAppClipDefaultExperienceLinkageRequest) The request body you use to attach a default App Clip experience to an App Store version. [`AppStoreVersionAppClipDefaultExperienceLinkageResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionAppClipDefaultExperienceLinkageResponse) A response that contains the ID of a single related Default App Clip Experiences resource. [`AppStoreVersionState`](/documentation/AppStoreConnectAPI/AppStoreVersionState) String that represents the state of an app version in the App Store. [`AppVersionState`](/documentation/AppStoreConnectAPI/AppVersionState) String that represents the state of an app version. [`AppStoreVersionAlternativeDistributionPackageLinkageResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionAlternativeDistributionPackageLinkageResponse) [`AppStoreVersionAppStoreReviewDetailLinkageResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionAppStoreReviewDetailLinkageResponse) [`AppStoreVersionAppStoreVersionExperimentsLinkagesResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionAppStoreVersionExperimentsLinkagesResponse) [`AppStoreVersionAppStoreVersionExperimentsV2LinkagesResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionAppStoreVersionExperimentsV2LinkagesResponse) [`AppStoreVersionAppStoreVersionLocalizationsLinkagesResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionAppStoreVersionLocalizationsLinkagesResponse) [`AppStoreVersionAppStoreVersionPhasedReleaseLinkageResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionAppStoreVersionPhasedReleaseLinkageResponse) [`AppStoreVersionAppStoreVersionSubmissionLinkageResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionAppStoreVersionSubmissionLinkageResponse) [`AppStoreVersionCustomerReviewsLinkagesResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionCustomerReviewsLinkagesResponse) [`AppStoreVersionGameCenterAppVersionLinkageResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionGameCenterAppVersionLinkageResponse) [`AppStoreVersionLocalizationAppPreviewSetsLinkagesResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionLocalizationAppPreviewSetsLinkagesResponse) [`AppStoreVersionLocalizationAppScreenshotSetsLinkagesResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionLocalizationAppScreenshotSetsLinkagesResponse) [`AppStoreVersionRoutingAppCoverageLinkageResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionRoutingAppCoverageLinkageResponse) --- 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)