---
title: List prerelease versions
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/get-v1-prereleaseversions
---

# List prerelease versions

Get a list of prerelease versions for all apps.

## URL

GET https://api.appstoreconnect.apple.com/v1/preReleaseVersions

## Query Parameters

fields[apps]: Fields to return for included related types. fields[builds]: Fields to return for included related types. fields[preReleaseVersions]: Fields to return for included related types. filter[app]: Attributes, relationships, and IDs by which to filter. filter[builds.expired]: Attributes, relationships, and IDs by which to filter. filter[builds.processingState]: Attributes, relationships, and IDs by which to filter. filter[builds]: Attributes, relationships, and IDs by which to filter. filter[platform]: Attributes, relationships, and IDs by which to filter. filter[version]: Attributes, relationships, and IDs by which to filter. include: Relationship data to include in the response. limit: Number of resources to return. limit[builds]: Number of included related resources to return. sort: Attributes by which to sort. filter[builds.version]: filter[builds.buildAudienceType]:

## Response Codes

200 OK: 400 Bad Request: An error occurred with your request. 401 Unauthorized: 403 Forbidden: Request not authorized. 429 :

## Mentioned in

App Store Connect API 4.1 release notes

## See Also

### Getting Prerelease Version Information

- [Read prerelease version information](appstoreconnectapi/get-v1-prereleaseversions-_id_.md)
- [Read the app information of a prerelease version](appstoreconnectapi/get-v1-prereleaseversions-_id_-app.md)
- [Get the app ID for a prerelease version](appstoreconnectapi/get-v1-prereleaseversions-_id_-relationships-app.md)