---
title: "Get operating system by ID"
method: GET
path: "/v1/operating-systems/{operatingSystemId}"
tags: ["Operating systems"]
---

# Get operating system by ID

`GET /v1/operating-systems/{operatingSystemId}`

## Request

- Base URL: `https://api.emma.ms/external`
- URL: `https://api.emma.ms/external/v1/operating-systems/{operatingSystemId}`
- Auth: HTTP bearer

Returns an operating system (supported by the cloud providers) by its ID. The method provides detailed information about each operating system, including its family, type, version, and architecture.

## Path parameters

- `operatingSystemId` integer, required

## Query parameters

- `projectId` integer

## Response `200`

Successful operation

- OperatingSystem
  - `id` integer: Operating system ID
  - `family` string: Operating system family
  - `type` string: Operating system type
  - `architecture` string: Operating system architecture
  - `version` string: Operating system version
  - `options` string: Operating system variant label ("Clean" for the base variant, or a driver/GPU label such as "Deep Learning Base OSS Nvidia Driver GPU AMI" for variants)

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `500`: Internal server error

---

[API](https://skmtc.dev/emma/apis/public-emma-api.md) - [All operations](https://skmtc.dev/emma/apis/public-emma-api/llms.txt) - [OpenAPI document](https://skmtc.dev/emma/apis/public-emma-api/revisions/9e55f0920078?raw)