---
title: "Retrieve a VM"
method: GET
path: "/vms/{name}"
tags: ["vms"]
---

# Retrieve a VM

`GET /vms/{name}`

## Response `200`

OK

- VM — unresolved $ref

## Other responses

- `404` — VM resource with the given name doesn't exist

## Changes

- **2023-01-26** `4b9547159dde` — 2 breaking, 1 info
  - the response's body type changed from `object` to no type for status `200`
  - removed the media type `application/x-ndjson` for the response with the status `200`
  - removed `#/components/schemas/VMMeta, #/components/schemas/VMSpec, #/components/schemas/VMState` from the response body `allOf` list for the response status `200`

[Change history](https://skmtc.dev/openai/apis/orchard/changes/vms/:name/get.md)

---

[API](https://skmtc.dev/openai/apis/orchard.md) · [All operations](https://skmtc.dev/openai/apis/orchard/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openai/orchard/revisions/df290e3bee7e/schema)