<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/prerelease-versions",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Prerelease Versions"
}
-->

# Prerelease Versions

Platform-specific versions of your app intended for distribution to beta testers.

## Discussion

A `preReleaseVersions` resource represents a version of your app intended for TestFlight testing, not for release on the store.

## Topics

### Getting Prerelease Version Information

[`GET /v1/preReleaseVersions`](/documentation/AppStoreConnectAPI/GET-v1-preReleaseVersions)

Get a list of prerelease versions for all apps.

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

Get information about a specific prerelease version.

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

Get the app information for a specific prerelease version.

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

### Getting Build Information

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

Get a list of builds of a specific prerelease version.

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

### Objects

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

A pre-release version associated with a build, representing a development or beta software version before App Store submission.

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

The response body for endpoints that read a single prerelease version of an app.

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

A response containing a list of pre-release versions for an app.

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

A response containing a single pre-release version, without related resources.

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

A response containing a list of pre-release versions, without related resources.

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

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

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


---

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)