List Available Xcode Versions for a macOS Version
List all Xcode versions available for a specific macOS version in Xcode Cloud.
URL
GET https://api.appstoreconnect.apple.com/v1/ciMacOsVersions/{id}/xcodeVersionsPath Parameters
| Name | Type | Description |
|---|---|---|
id Required | string | The opaque resource ID that uniquely identifies the macOS Versions resource. |
Query Parameters
| Name | Type | Description |
|---|---|---|
fields[ciMacOsVersions] Optional | [string] | Additional fields to include for each Xcode Versions resource returned by the response. |
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 Optional | integer | The number of Xcode Versions resources to return. |
limit[macOsVersions] Optional | integer | The number of included Xcode Versions resources to return if the macOS versions relationship is included. |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | CiXcodeVersionsResponse | 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 lists Xcode versions available in Xcode Cloud for a specific macOS version. Use the data provided in the response to display available Xcode versions and test destinations on a dashboard.