---
title: List available xcode versions for a macos version
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/get-v1-cimacosversions-_id_-xcodeversions
---

# 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}/xcodeVersions

## Path Parameters

id: The opaque resource ID that uniquely identifies the macOS Versions resource.

## Query Parameters

fields[ciMacOsVersions]: Additional fields to include for each Xcode Versions resource returned by the response. fields[ciXcodeVersions]: Additional fields to include for each Xcode Versions resource returned by the response. include: The relationship data to include in the response. limit: The number of Xcode Versions resources to return. limit[macOsVersions]: The number of included Xcode Versions resources to return if the macOS versions relationship is included.

## Response Codes

200 OK: The request completed successfully. 400 Bad Request: An error occurred with your request. 401 Unauthorized: 403 Forbidden: Request not authorized. 404 Not Found: Resource not found. 429 :

## Discussion

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. Example Request and Response

## See Also

### Getting macOS Version Information

- [List all macos versions available in xcode cloud](appstoreconnectapi/get-v1-cimacosversions.md)
- [Read macos version information](appstoreconnectapi/get-v1-cimacosversions-_id_.md)
- [List Xcode version IDs for a CI macOS version](appstoreconnectapi/get-v1-cimacosversions-_id_-relationships-xcodeversions.md)