List Builds

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

URL

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

Query Parameters

Name	Type	Description
`fields[appEncryptionDeclarations]` Optional	[string]	Fields to return for included related types.
`fields[apps]` Optional	[string]	Fields to return for included related types.
`fields[betaTesters]` Optional	[string]	Fields to return for included related types.
`fields[builds]` Optional	[string]	Fields to return for included related types.
`fields[preReleaseVersions]` Optional	[string]	Fields to return for included related types.
`filter[app]` Optional	[string]	Attributes, relationships, and IDs by which to filter.
`filter[expired]` Optional	[string]	Attributes, relationships, and IDs by which to filter.
`filter[id]` Optional	[string]	Attributes, relationships, and IDs by which to filter.
`filter[preReleaseVersion]` Optional	[string]	Attributes, relationships, and IDs by which to filter.
`filter[processingState]` Optional	[string]	Attributes, relationships, and IDs by which to filter.
`filter[version]` Optional	[string]	Attributes, relationships, and IDs by which to filter.
`include` Optional	[string]	Relationship data to include in the response.
`limit` Optional	integer	Number of resources to return.
`limit[individualTesters]` Optional	integer	Number of included related resources to return.
`sort` Optional	[string]	Attributes by which to sort.
`filter[usesNonExemptEncryption]` Optional	[string]	Attributes, relationships, and IDs by which to filter.
`filter[preReleaseVersion.version]` Optional	[string]	Attributes, relationships, and IDs by which to filter.
`fields[buildBetaDetails]` Optional	[string]	Fields to return for included related types.
`filter[betaGroups]` Optional	[string]	Attributes, relationships, and IDs by which to filter.
`fields[betaAppReviewSubmissions]` Optional	[string]	Fields to return for included related types.
`filter[betaAppReviewSubmission.betaReviewState]` Optional	[string]	Attributes, relationships, and IDs by which to filter.
`fields[betaBuildLocalizations]` Optional	[string]	Fields to return for included related types.
`limit[betaBuildLocalizations]` Optional	integer	Number of included related resources to return.
`limit[icons]` Optional	integer
`fields[appStoreVersions]` Optional	[string]
`fields[buildIcons]` Optional	[string]
`filter[appStoreVersion]` Optional	[string]
`filter[preReleaseVersion.platform]` Optional	[string]
`filter[buildAudienceType]` Optional	[string]
`limit[buildBundles]` Optional	integer
`limit[betaGroups]` Optional	integer
`exists[usesNonExemptEncryption]` Optional	boolean

Response Codes

Status	Reason	Type	Description
200	OK Content-Type: application/json	`BuildsResponse`
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.
429	Content-Type: application/json	`ErrorResponse`

List Builds

URL

Query Parameters

Response Codes

See Also

Getting Build Information