---
title: "Get CPU / memory / network stats"
method: GET
path: "/sandboxes/{id}/stats"
tags: ["Observability"]
---

# Get CPU / memory / network stats

`GET /sandboxes/{id}/stats`

Returns an average and a time-series of CPU%, memory%, and network
bytes/sec for the requested lookback window. Server targets ~250 evenly
spaced data points; step interval adjusts with `hoursAgo`.

## Path parameters

- `id` string, required

## Query parameters

- `hoursAgo` integer

## Response `200`

Stats payload

- StatsEnvelope
  - `message` string, required
  - `data` Stats, required
    - `average` object, required
      - `memory` StatsAverageNumeric, required
        - `totalInPercentage` number, required — Mean utilization 0–100.
        - `size` number, required — Cap value. For memory this is MB, for CPU this is MHz.
      - `cpu` StatsAverageNumeric, required
        - `totalInPercentage` number, required — Mean utilization 0–100.
        - `size` number, required — Cap value. For memory this is MB, for CPU this is MHz.
      - `network` StatsAverageNetwork, required
        - `value` number, nullable
        - `total` number, nullable
        - `totalInPercentage` number, nullable
        - `bytesPerSecond` number, nullable
    - `replicaCount` integer, required — Always `1` for sandboxes.
    - `results` StatsTimelinePoint[], required
      - `date` string, date-time, required
      - `memory` number, required
      - `cpu` number, required
      - `network` object, required
        - `bytesPerSecond` number, nullable, required
    - `responseTime` object, nullable, required — Always `null` for sandboxes (no HTTP-facing proxy).

## Other responses

- `400` — Validation error / invalid state transition
- `404` — Sandbox or related resource not found (also returned when owned by another user)

---

[API](https://skmtc.dev/brimblehq/apis/brimble-sandbox-api.md) · [All operations](https://skmtc.dev/brimblehq/apis/brimble-sandbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brimblehq/brimble-sandbox-api/revisions/7fe2df041597/schema)