List All Builds Xcode Cloud Created in App Store Connect
List All App Store Connect and TestFlight Builds when it performed a build.
URL
GET https://api.appstoreconnect.apple.com/v1/ciBuildRuns/{id}/buildsPath Parameters
| Name | Type | Description |
|---|---|---|
id Required | string | The opaque resource ID that uniquely identifies the Build Runs resource. |
Query Parameters
| Name | Type | Description |
|---|---|---|
fields[betaBuildLocalizations] Optional | [string] | Additional fields to include for each Builds resource returned by the response. |
fields[betaTesters] Optional | [string] | Additional fields to include for each Builds resource returned by the response. |
fields[buildIcons] Optional | [string] | Additional fields to include for each Builds resource returned by the response. |
fields[builds] Optional | [string] | Additional fields to include for each Builds resource returned by the response. |
filter[appStoreVersion] Optional | [string] | Filter the returned builds using the ID of the related App Store Versions resource. |
filter[app] Optional | [string] | Filter the returned builds using the ID of the related Apps resource. |
filter[betaAppReviewSubmission.betaReviewState] Optional | [string] | Filter the returned builds using the beta review state attribute. |
filter[betaGroups] Optional | [string] | Filter the returned builds using the ID of the related Beta Groups resource. |
filter[expired] Optional | [string] | Filter the returned builds using the expired attribute. |
filter[id] Optional | [string] | Filter the returned builds using the ID of the Builds resource. |
filter[preReleaseVersion.platform] Optional | [string] | Filter the returned builds using the platform attribute of the Pre-Release Versions resource. |
filter[preReleaseVersion.version] Optional | [string] | Filter the returned builds using the version attribute of the Pre-Release Versions resource. |
filter[preReleaseVersion] Optional | [string] | Filter the returned builds using the ID of the related Pre-Release Versions resource. |
filter[processingState] Optional | [string] | Filter the returned builds using the processing state attribute. |
filter[usesNonExemptEncryption] Optional | [string] | Filter the returned builds using the uses nonexempt encryption attribute. |
filter[version] Optional | [string] | Filter the returned builds using the version attribute. |
include Optional | [string] | The relationship data to include in the response. |
limit Optional | integer | The number of Builds resources to return. |
limit[betaBuildLocalizations] Optional | integer | The number of included Builds resources to return if the beta build localization relationship is included. |
limit[icons] Optional | integer | The number of included Builds resources to return if the icons relationship is included. |
limit[individualTesters] Optional | integer | The number of included Builds resources to return if the individual testers relationship is included. |
sort Optional | [string] | Attributes by which to sort the returned Builds resources. |
filter[buildAudienceType] Optional | [string] | |
limit[buildBundles] Optional | integer | |
fields[buildBundles] Optional | [string] | |
fields[betaGroups] Optional | [string] | |
limit[betaGroups] Optional | integer | |
fields[betaAppReviewSubmissions] Optional | [string] | |
fields[buildBetaDetails] Optional | [string] | |
fields[preReleaseVersions] Optional | [string] | |
fields[appStoreVersions] Optional | [string] | |
fields[appEncryptionDeclarations] Optional | [string] | |
fields[apps] Optional | [string] | |
exists[usesNonExemptEncryption] Optional | boolean | |
fields[buildUploads] Optional | [string] |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | BuildsResponse | The request completed successfully. |
| 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 |