---
title: Read macos version information
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/get-v1-cimacosversions-_id_
---

# Read macos version information

Get information about a specific macOS version that’s available to Xcode Cloud workflows.

## URL

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

## Path Parameters

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

## Query Parameters

fields[ciMacOsVersions]: Additional fields to include for the macOS Versions resource returned by the response. fields[ciXcodeVersions]: Additional fields to include for the macOS Versions resource returned by the response. include: The relationship data to include in the response. 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 accesses information about a macOS version available to Xcode Cloud workflows. Use the data provided in the response to read additional information; for example, Xcode versions. Example Request and Response

## See Also

### Getting macOS Version Information

- [List all macos versions available in xcode cloud](appstoreconnectapi/get-v1-cimacosversions.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)