---
title: List all app store versions for an app
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/get-v1-apps-_id_-appstoreversions
---

# List all app store versions for an app

Get a list of all App Store versions of an app across all platforms.

## URL

GET https://api.appstoreconnect.apple.com/v1/apps/{id}/appStoreVersions

## Path Parameters

id: An opaque resource ID that uniquely identifies the apps resource. Obtain the app resource ID from the List apps response.

## Query Parameters

limit: Number of resources to return. include: Relationship data to include in the response. fields[apps]: Fields to return for included related types. fields[appStoreVersionSubmissions]: Fields to return for included related types. fields[builds]: Fields to return for included related types. fields[appStoreVersions]: Fields to return for included related types. fields[appStoreReviewDetails]: Fields to return for included related types. fields[appStoreVersionPhasedReleases]: Fields to return for included related types. fields[routingAppCoverages]: Fields to return for included related types. fields[appStoreVersionLocalizations]: Fields to return for included related types. filter[id]: Fields to return for included related types. filter[versionString]: Fields to return for included related types. filter[platform]: Fields to return for included related types. filter[appStoreState]: Fields to return for included related types. limit[appStoreVersionLocalizations]: fields[appStoreVersionExperiments]: limit[appStoreVersionExperiments]: fields[appClipDefaultExperiences]: limit[appStoreVersionExperimentsV2]: filter[appVersionState]: fields[alternativeDistributionPackages]: fields[gameCenterAppVersions]:

## Response Codes

200 OK: Request succeeded. 400 Bad Request: An error occurred with your request. 401 Unauthorized: 403 Forbidden: Request not authorized. 404 Not Found: Resource not found. 429 :

## Mentioned in

Creating alternative distribution packages App Store Connect API 1.3 release notes

## Discussion

Discussion Example Request and Response

## See Also

### Getting App Store details for your app

- [List all app infos for an app](appstoreconnectapi/get-v1-apps-_id_-appinfos.md)
- [List app info IDs for an app](appstoreconnectapi/get-v1-apps-_id_-relationships-appinfos.md)
- [List App Store version IDs for an app](appstoreconnectapi/get-v1-apps-_id_-relationships-appstoreversions.md)
- [Read the end user license agreement information of an app](appstoreconnectapi/get-v1-apps-_id_-enduserlicenseagreement.md)
- [Get the end user license agreement ID for an app](appstoreconnectapi/get-v1-apps-_id_-relationships-enduserlicenseagreement.md)
- [List All Custom Product Pages for an App](appstoreconnectapi/get-v1-apps-_id_-appcustomproductpages.md)
- [Get all custom product page resource ids for an app](appstoreconnectapi/get-v1-apps-_id_-relationships-appcustomproductpages.md)
- [List all app store experiments for an app](appstoreconnectapi/get-v1-apps-_id_-appstoreversionexperimentsv2.md)
- [List App Store version experiment IDs for an app](appstoreconnectapi/get-v1-apps-_id_-relationships-appstoreversionexperimentsv2.md)