---
title: "GET /v1/sandboxes/{id}/status"
method: GET
path: "/v1/sandboxes/{id}/status"
---

# GET /v1/sandboxes/{id}/status

`GET /v1/sandboxes/{id}/status`

## Path parameters

- `id` string, required — Sandbox ID (UID or name)

## Query parameters

- `from` string, date-time — Start time for historical data (ISO 8601)
- `to` string, date-time — End time for historical data (ISO 8601)

## Response `200`

Sandbox resource usage

- SandboxStatus
  - `sandbox_name` string, required — Sandbox name
  - `timestamp` string, required — Response timestamp (ISO 8601)
  - `current` CurrentUsage — Current resource usage
    - `cpu_percent` number, required — CPU usage percentage (0-100)
    - `memory_mb` number, required — Current memory usage in megabytes
    - `memory_percent` number, required — Memory usage percentage (0-100)
  - `history` HistoryPoint[] — Historical usage data
    - `timestamp` string, required — Sample timestamp (ISO 8601)
    - `cpu_percent` number, required — CPU usage percentage (0-100)
    - `memory_mb` number, required — Memory usage in megabytes

## Other responses

- `401` — Unauthorized - API key required
- `403` — Forbidden - Sandbox does not belong to user
- `404` — Sandbox not found
- `500` — Internal server error

## Changes

- **2026-01-26** `260daed67193` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/avm-codes/apis/avm-sandbox-platform-api/changes/v1/sandboxes/:id/status/get.md)

---

[API](https://skmtc.dev/avm-codes/apis/avm-sandbox-platform-api.md) · [All operations](https://skmtc.dev/avm-codes/apis/avm-sandbox-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/avm-codes/avm-sandbox-platform-api/revisions/260daed67193/schema)