<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/app-store-version-experiments",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "App Store version experiments"
}
-->

# App Store version experiments

Test elements of your App Store product page.

## Topics

### Managing App Store version experiments

[`GET /v1/appStoreVersions/{id}/appStoreVersionExperiments`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-appStoreVersionExperiments)

Get a list of all experiments for an App Store version of an app across all platforms.

[`GET /v1/appStoreVersions/{id}/relationships/appStoreVersionExperiments`](/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.

[`GET /v1/appStoreVersions/{id}/appStoreVersionExperimentsV2`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-appStoreVersionExperimentsV2)

Get a list of all experiments for an App Store version of an app across all platforms.

[`GET /v1/appStoreVersions/{id}/relationships/appStoreVersionExperimentsV2`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersions-_id_-relationships-appStoreVersionExperimentsV2)

Get a list of all experiments IDs for an App Store version across all platforms.

[`GET /v2/appStoreVersionExperiments/{id}`](/documentation/AppStoreConnectAPI/GET-v2-appStoreVersionExperiments-_id_)

Get information for a specific App Store version experiment.

[`GET /v2/appStoreVersionExperiments/{id}/appStoreVersionExperimentTreatments`](/documentation/AppStoreConnectAPI/GET-v2-appStoreVersionExperiments-_id_-appStoreVersionExperimentTreatments)

Get a list of all treatments for a specific App Store version experiment.

[`GET /v2/appStoreVersionExperiments/{id}/relationships/appStoreVersionExperimentTreatments`](/documentation/AppStoreConnectAPI/GET-v2-appStoreVersionExperiments-_id_-relationships-appStoreVersionExperimentTreatments)

Get a list of experiment treatment IDs for a specific App Store version experiment.

[`POST /v2/appStoreVersionExperiments`](/documentation/AppStoreConnectAPI/POST-v2-appStoreVersionExperiments)

Add a new experiment to an App Store version.

[`PATCH /v2/appStoreVersionExperiments/{id}`](/documentation/AppStoreConnectAPI/PATCH-v2-appStoreVersionExperiments-_id_)

Update the name, the started state, and the proportion of traffic to send to an App Store experiment.

[`DELETE /v2/appStoreVersionExperiments/{id}`](/documentation/AppStoreConnectAPI/DELETE-v2-appStoreVersionExperiments-_id_)

Delete a specific App Store version experiment before it starts.

[`GET /v1/appStoreVersionExperiments/{id}`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersionExperiments-_id_)

Get information for a specific App Store version experiment.

[`GET /v1/appStoreVersionExperiments/{id}/appStoreVersionExperimentTreatments`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersionExperiments-_id_-appStoreVersionExperimentTreatments)

Get a list of all treatments for a specific App Store version experiment.

[`GET /v1/appStoreVersionExperiments/{id}/relationships/appStoreVersionExperimentTreatments`](/documentation/AppStoreConnectAPI/GET-v1-appStoreVersionExperiments-_id_-relationships-appStoreVersionExperimentTreatments)

[`PATCH /v1/appStoreVersionExperiments/{id}`](/documentation/AppStoreConnectAPI/PATCH-v1-appStoreVersionExperiments-_id_)

Update the name, the started state, and the proportion of traffic to send to an App Store experiment.

[`POST /v1/appStoreVersionExperiments`](/documentation/AppStoreConnectAPI/POST-v1-appStoreVersionExperiments)

Add a new experiment to an App Store version.

[`DELETE /v1/appStoreVersionExperiments/{id}`](/documentation/AppStoreConnectAPI/DELETE-v1-appStoreVersionExperiments-_id_)

Delete a specific App Store version experiment before it starts.

### Objects

[`AppStoreVersionExperimentV2`](/documentation/AppStoreConnectAPI/AppStoreVersionExperimentV2)

An A/B test comparing two product page variants for an App Store version to determine which drives more downloads.

[`AppStoreVersionExperimentV2CreateRequest`](/documentation/AppStoreConnectAPI/AppStoreVersionExperimentV2CreateRequest)

The request body you use to create an App Store version experiment.

[`AppStoreVersionExperimentV2Response`](/documentation/AppStoreConnectAPI/AppStoreVersionExperimentV2Response)

A response containing a single App Store product page A/B experiment.

[`AppStoreVersionExperimentV2UpdateRequest`](/documentation/AppStoreConnectAPI/AppStoreVersionExperimentV2UpdateRequest)

The request body you use to update an app store version experiment v2update request.

[`AppStoreVersionExperimentsV2Response`](/documentation/AppStoreConnectAPI/AppStoreVersionExperimentsV2Response)

A response containing a list of A/B product page experiments for an App Store version.

[`AppStoreVersionExperiment`](/documentation/AppStoreConnectAPI/AppStoreVersionExperiment)

[`AppStoreVersionExperimentCreateRequest`](/documentation/AppStoreConnectAPI/AppStoreVersionExperimentCreateRequest)

[`AppStoreVersionExperimentResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionExperimentResponse)

[`AppStoreVersionExperimentUpdateRequest`](/documentation/AppStoreConnectAPI/AppStoreVersionExperimentUpdateRequest)

[`AppStoreVersionExperimentsResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionExperimentsResponse)

[`AppStoreVersionExperimentAppStoreVersionExperimentTreatmentsLinkagesResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionExperimentAppStoreVersionExperimentTreatmentsLinkagesResponse)

[`AppStoreVersionExperimentTreatmentAppStoreVersionExperimentTreatmentLocalizationsLinkagesResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionExperimentTreatmentAppStoreVersionExperimentTreatmentLocalizationsLinkagesResponse)

[`AppStoreVersionExperimentTreatmentLocalizationAppPreviewSetsLinkagesResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionExperimentTreatmentLocalizationAppPreviewSetsLinkagesResponse)

[`AppStoreVersionExperimentTreatmentLocalizationAppScreenshotSetsLinkagesResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionExperimentTreatmentLocalizationAppScreenshotSetsLinkagesResponse)

[`AppStoreVersionExperimentV2AppStoreVersionExperimentTreatmentsLinkagesResponse`](/documentation/AppStoreConnectAPI/AppStoreVersionExperimentV2AppStoreVersionExperimentTreatmentsLinkagesResponse)



---

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)