---
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

- **2026-08-22** `7f90a64e0952` — 1 info
  - added the optional property `data/items/attributes/team/limits/bgp_session_per_ip` to the response with the `200` status
- **2026-08-20** `437c7a97e596` — 1 warning, 1 info
  - removed the optional property `data/items/attributes/team/limits/prefix` from the response with the `200` status
  - added the optional property `data/items/attributes/team/limits/public_network` to the response with the `200` status
- **2026-08-05** `ae7dcb22727c` — 1 info
  - added the optional property `data/items/attributes/team/limits/prefix` to the response with the `200` status
- **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/093a8a1ebb2d/schema)