Read Xcode Version Information
Get information about a specific Xcode version that’s available to Xcode Cloud workflows.
URL
GET https://api.appstoreconnect.apple.com/v1/ciXcodeVersions/{id}Path Parameters
| Name | Type | Description |
|---|---|---|
id Required | string | The opaque resource ID that uniquely identifies the Xcode Versions resource. |
Query Parameters
| Name | Type | Description |
|---|---|---|
fields[ciXcodeVersions] Optional | [string] | Additional fields to include for the Xcode Versions resource returned by the response. |
include Optional | [string] | The relationship data to include in the response. |
limit[macOsVersions] Optional | integer | The number of included Xcode Versions resources to return if the macOS versions relationship is included. |
fields[ciMacOsVersions] Optional | [string] | Additional fields to include for the Xcode Versions resource returned by the response. |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | CiXcodeVersionResponse | 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 accesses detailed information for a specific Xcode version available to Xcode Cloud workflows. Use the data provided in the response to display available Xcode versions and test destinations on a dashboard or to read additional information; for example, macOS version information.