Contents

List All Xcode Versions Available in Xcode Cloud

List all Xcode versions that are available to Xcode Cloud workflows.

URL

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

Query Parameters

NameTypeDescription
fields[ciXcodeVersions] Optional[string]

Additional fields to include for each Xcode Versions resource returned by the response.

include Optional[string]

The relationship data to include in the response.

limit Optionalinteger

The number of Xcode Versions resources to return.

limit[macOsVersions] Optionalinteger

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 each Xcode Versions resource returned by the response.

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
CiXcodeVersionsResponse

The request completed successfully.

400Bad Request
Content-Type: application/json
ErrorResponse

An error occurred with your request.

401Unauthorized
Content-Type: application/json
ErrorResponse

403Forbidden
Content-Type: application/json
ErrorResponse

Request not authorized.

429
Content-Type: application/json
ErrorResponse

Discussion

The example request below lists Xcode versions available to Xcode Cloud workflows and supported test destinations, including information about available simulated devices. 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.

Example Request and Response

See Also

Getting Xcode Version Information