---
title: List available macos versions for an xcode version
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/get-v1-cixcodeversions-_id_-macosversions
---

# List available macos versions for an xcode version

List all macOS versions available in Xcode Cloud that support a specific Xcode version.

## URL

GET https://api.appstoreconnect.apple.com/v1/ciXcodeVersions/{id}/macOsVersions

## Path Parameters

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

## Query Parameters

fields[ciMacOsVersions]: Additional fields to include for each macOS Versions resource returned by the response. fields[ciXcodeVersions]: Additional fields to include for each macOS Versions resource returned by the response. include: The relationship data to include in the response. limit: The number of macOS Versions resources to return. limit[xcodeVersions]: The number of included macOS Versions resources to return if the Xcode 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 macOS versions available for a specific Xcode version. Use the information provided in the response to update workflows, build dashboards, and more. Example Request and Response

## See Also

### Getting Xcode Version Information

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