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

# List builds

Find and list builds for all apps in App Store Connect.

## URL

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

## Query Parameters

fields[appEncryptionDeclarations]: Fields to return for included related types. fields[apps]: Fields to return for included related types. fields[betaTesters]: 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[expired]: Attributes, relationships, and IDs by which to filter. filter[id]: Attributes, relationships, and IDs by which to filter. filter[preReleaseVersion]: Attributes, relationships, and IDs by which to filter. filter[processingState]: 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[individualTesters]: Number of included related resources to return. sort: Attributes by which to sort. filter[usesNonExemptEncryption]: Attributes, relationships, and IDs by which to filter. filter[preReleaseVersion.version]: Attributes, relationships, and IDs by which to filter. fields[buildBetaDetails]: Fields to return for included related types. filter[betaGroups]: Attributes, relationships, and IDs by which to filter. fields[betaAppReviewSubmissions]: Fields to return for included related types. filter[betaAppReviewSubmission.betaReviewState]: Attributes, relationships, and IDs by which to filter. fields[betaBuildLocalizations]: Fields to return for included related types. limit[betaBuildLocalizations]: Number of included related resources to return. limit[icons]: fields[appStoreVersions]: fields[buildIcons]: filter[appStoreVersion]: filter[preReleaseVersion.platform]: filter[buildAudienceType]: limit[buildBundles]: limit[betaGroups]: exists[usesNonExemptEncryption]: fields[betaGroups]: fields[buildBundles]: fields[buildUploads]:

## Response Codes

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

## See Also

### Getting Build Information

- [Read build information](appstoreconnectapi/get-v1-builds-_id_.md)
- [Read the app information of a build](appstoreconnectapi/get-v1-builds-_id_-app.md)
- [Read the app id of a build](appstoreconnectapi/get-v1-builds-_id_-relationships-app.md)
- [Read the app store version information of a build](appstoreconnectapi/get-v1-builds-_id_-appstoreversion.md)
- [Get the App Store version ID for a build](appstoreconnectapi/get-v1-builds-_id_-relationships-appstoreversion.md)
- [Read the prerelease version of a build](appstoreconnectapi/get-v1-builds-_id_-prereleaseversion.md)
- [Get the prerelease version ID for a build](appstoreconnectapi/get-v1-builds-_id_-relationships-prereleaseversion.md)
- [Read Usage Metrics for a Beta Build](appstoreconnectapi/get-v1-builds-_id_-metrics-betabuildusages.md)