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

Name	Type	Description
`id` Required	string	An opaque resource ID that uniquely identifies the apps resource. Obtain the app resource ID from the List Apps response.

Query Parameters

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

Response Codes

Status	Reason	Type	Description
200	OK Content-Type: application/json	`AppStoreVersionsResponse`	Request succeeded.
400	Bad Request Content-Type: application/json	`ErrorResponse`	An error occurred with your request.
401	Unauthorized Content-Type: application/json	`ErrorResponse`
403	Forbidden Content-Type: application/json	`ErrorResponse`	Request not authorized.
404	Not Found Content-Type: application/json	`ErrorResponse`	Resource not found.
429	Content-Type: application/json	`ErrorResponse`

List All App Store Versions for an App

URL

Path Parameters

Query Parameters

Response Codes

Mentioned in

Discussion

Example Request and Response

See Also

Getting App Store details for your app