---
title: "GET /v1/sandboxes/:id/metrics — per-sandbox metrics (API key, org inferred from key)."
method: GET
path: "/v1/sandboxes/{sandbox_id}/metrics"
tags: ["sandboxes"]
---

# GET /v1/sandboxes/:id/metrics — per-sandbox metrics (API key, org inferred from key).

`GET /v1/sandboxes/{sandbox_id}/metrics`

## Path parameters

- `sandbox_id` string, uuid, required

## Query parameters

- `range_secs` integer, nullable
- `step_secs` integer, nullable

## Response `200`

Sandbox metrics

- SandboxMetricsResponse — Per-sandbox metrics over a time range, keyed by metric (`cpu`, `memory_bytes`, `net_rx_bytes_rate`, …). See `plans/monitoring-plan.md` § B for the catalog.
  - `metrics` object, required — Metric key → series. An empty series means "no data in range".
  - `range` MetricsRange, required — The resolved time window a metrics response covers.
    - `end` integer, required — Window end, epoch milliseconds.
    - `start` integer, required — Window start, epoch milliseconds.
    - `step_secs` integer, required — Sample resolution in seconds.
  - `sandbox_id` string, uuid, required — The sandbox these metrics belong to.

## Other responses

- `400` — Invalid range/step
- `401` — Unauthorized
- `404` — Sandbox not found
- `502` — Metrics backend unavailable

---

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