---
title: List all macos versions available in xcode cloud
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/get-v1-cimacosversions
---

# List all macos versions available in xcode cloud

List all macOS versions available to Xcode Cloud workflows.

## URL

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

## 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. 429 :

## Discussion

Discussion The example request below lists macOS versions available to Xcode Cloud workflows. Use the information provided in the response to read additional data; for example, Xcode version information. Example Request and Response

## See Also

### Getting macOS Version Information

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