---
title: "List virtual machines"
method: GET
path: "/virtual-machines"
---

# List virtual machines

`GET /virtual-machines`

Returns a list of all the virtual machines in your account

## Query parameters

- `cloud_id` integer
- `search` string
- `filter_os` string
- `filter_os_version` string
- `include_os_info` integer

## Response `200`

A list of virtual machines

- object[]
  - `id` integer, required — The virtual machine's id in Aikido.
  - `active` integer, required — 0 or 1 representing if the virtual machine is active.
  - `name` string, required — The virtual machine's name.
  - `region` string, required — The region where the virtual machine is located.
  - `latest_snapshot_id` string, required — The id of the virtual machine's latest snapshot.
  - `external_id` string, required — The id of the virtual machine as displayed in the related cloud.
  - `created_at` integer, required — The timestamp of when the virtual machine was created in Aikido.
  - `count_open_issues` integer, required — The amount of open issues related to this virtual machine.
  - `count_ignored_issues` integer, required — The amount of ignored issues related to this virtual machine.
  - `purpose` string, required — The purpose of this virtual machine.
  - `cloud_id` integer, required — The cloud id in Aikido related to this virtual machine.
  - `last_scanned_at` integer, required — The timestamp of the last scan of this virtual machine.
  - `instance_count` integer, required — The amount of instances related to this virtual machine.
  - `environment` string, required — The type of environment this virtual machine is used for. Can be 'production', 'staging' or 'development'.
  - `cloud_kind` string, required — The kind of cloud this virtual machine is located in.
  - `os` string, required — The operating system of the virtual machine. When unknown this will be null.
  - `os_version` string, required — The operating system version of the virtual machine. When unknown this will be null.

---

[API](https://skmtc.net/aikido/apis/authorization.md) · [All operations](https://skmtc.net/aikido/apis/authorization/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aikido/authorization/revisions/5445e7c21137/schema)