---
title: "Retrieve VM metrics"
method: GET
path: "/virtual_machines/{virtual_machine_id}/metrics"
tags: ["Virtual machines"]
---

# Retrieve VM metrics

`GET /virtual_machines/{virtual_machine_id}/metrics`

Retrieve a time series for a single metric of a Virtual Machine.

## Path parameters

- `virtual_machine_id` string, required

## Query parameters

- `metric` 'cpu' | 'memory' | 'network' | 'disk', required
- `range` '5m' | '15m' | '1h' | '24h'
- `force_refresh` boolean

## Response `200`

Success

---

[API](https://skmtc.net/latitude/apis/latitude-sh-api.md) · [All operations](https://skmtc.net/latitude/apis/latitude-sh-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/latitude/latitude-sh-api/versions/7302d79e39bb/schema)