Read Xcode Cloud Build Information
Get information about a specific Xcode Cloud build.
URL
GET https://api.appstoreconnect.apple.com/v1/ciBuildRuns/{id}Path Parameters
| Name | Type | Description |
|---|---|---|
id Required | string | The opaque resource ID that uniquely identifies the Build Runs resource. |
Query Parameters
| Name | Type | Description |
|---|---|---|
fields[ciBuildRuns] Optional | [string] | Additional fields to include for the Build Runs resource returned by the response. |
include Optional | [string] | The relationship data to include in the response. |
limit[builds] Optional | integer | The number of included Build Runs resources to return if the builds relationship is included. |
fields[builds] Optional | [string] | Additional fields to include for the Build Runs resource returned by the response. |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | CiBuildRunResponse | 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 |
Discussion
The example request below retrieves detailed information for a specific build. Use the data provided in the response to display detailed build information on a dashboard or to access related information for each action Xcode Cloud performed.