---
title: "List of owned, unterminated virtual machines"
method: GET
path: "/virtual-machines/"
tags: ["Virtual Machines"]
---

# List of owned, unterminated virtual machines

`GET /virtual-machines/`

## Request

- Base URL: `https://cloud-api.voltagepark.com/api/v1`
- URL: `https://cloud-api.voltagepark.com/api/v1/virtual-machines/`
- Auth: one of:
  - HTTP bearer
  - API key in header `UI-Authorization`
- TypeScript: <https://skmtc.dev/voltagepark/apis/voltage-park-on-demand-api/docs/virtual-machines/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- PaginatedResultFullVirtualMachineDetails
  - `results` FullVirtualMachineDetails[], required
    - `id` string, uuid, required
    - `hostnode_id` string, uuid, required
    - `type` 'ondem' | 'spot' | 'subscription', required
    - `status` 'Running' | 'StoppedDisassociated' | 'Stopped' | 'Terminated' | 'Outbid' | 'Relocating', required
    - `name` string, required
    - `resources` HardwareResources, required: Catalog total resources model (for when GPU count or other resource count is potentially 0). Used to keep stock of resources on a host
      - `gpus` object, required
      - `vcpu_count` integer, required
      - `ram_gb` integer, required
      - `storage_gb` integer, required
    - `operating_system` 'Ubuntu 20.04 LTS' | 'Ubuntu 22.04 LTS' | 'TensorML 20 TensorFlow' | 'TensorML 20 PyTorch' | 'TensorML 20 Everything' | 'Ubuntu 24.04 LTS' | 'TensorML 24 TensorFlow' | 'TensorML 24 PyTorch' | 'TensorML 24 Everything' | 'Windows 10', required
    - `pricing` VirtualMachinePricing, required
      - `gpus_per_hr` string, required
      - `vcpus_per_hr` string, required
      - `ram_per_hr` string, required
      - `storage_per_hr` string, required
      - `total_associated_per_hr` string, required
      - `total_disassociated_per_hr` string, required
    - `public_ip` string, required
    - `internal_ip` string, required
    - `port_forwards` PortForwardConfig[], required
      - `internal_port` integer, required
      - `external_port` integer, required
    - `timestamp_creation` string, date-time, required
    - `tags` string[], required
  - `total_result_count` integer, required
  - `has_previous` boolean, required
  - `has_next` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/voltagepark/apis/voltage-park-on-demand-api.md) - [All operations](https://skmtc.dev/voltagepark/apis/voltage-park-on-demand-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voltagepark/apis/voltage-park-on-demand-api/revisions/11c2e9146826?raw)