---
title: "List VMs"
method: GET
path: "/virtual_machines"
tags: ["Virtual machines"]
---

# List VMs

`GET /virtual_machines`

Show all Team's Virtual Machines.

## Query parameters

- `filter[project]` string
- `filter[tags]` string
- `extra_fields[virtual_machines]` string
- `sort` string
- `page[size]` integer
- `page[number]` integer
- `stats[total]` string

## Response `200`

Success

## Other responses

- `400` — Bad Request

## Changes

> 29 revisions in range; 22 could not be searched.

- **2026-07-26** `52c7ba2f0f3a` — 1 info
  - added the optional property `data/items/attributes/plan/slug` to the response with the `200` status
- **2026-07-21** `885dec47dd47` — 5 breaking, 21 info
  - the response property `data/items/attributes/credentials/host` became nullable for the status `200`
  - the response property `data/items/attributes/credentials/password` became nullable for the status `200`
  - the response property `data/items/attributes/credentials/ssh_keys` became nullable for the status `200`
  - the response property `data/items/attributes/credentials/username` became nullable for the status `200`
  - …22 more

[Change history](https://skmtc.dev/latitude/apis/latitude-sh-api/changes/virtual_machines/get.md)

---

[API](https://skmtc.dev/latitude/apis/latitude-sh-api.md) · [All operations](https://skmtc.dev/latitude/apis/latitude-sh-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/latitude/latitude-sh-api/revisions/c80535f26dd7/schema)