---
title: "GET /sandboxes"
method: GET
path: "/sandboxes"
tags: ["sandboxes"]
---

# GET /sandboxes

`GET /sandboxes`

List all running sandboxes

## Query parameters

- `metadata` string

## Response `200`

Successfully returned all running sandboxes

- ListedSandbox[]
  - `templateID` string, required — Identifier of the template from which is the sandbox created
  - `alias` string — Alias of the template
  - `sandboxID` string, required — Identifier of the sandbox
  - `clientID` string, required — Identifier of the client
  - `startedAt` string, date-time, required — Time when the sandbox was started
  - `endAt` string, date-time, required — Time when the sandbox will expire
  - `cpuCount` integer, required — CPU cores for the sandbox
  - `memoryMB` integer, required — Memory for the sandbox in MiB
  - `diskSizeMB` integer, required — Disk size for the sandbox in MiB
  - `metadata` unknown
  - `state` 'running' | 'paused', required — State of the sandbox
  - `envdVersion` string, required — Version of the envd running in the sandbox
  - `volumeMounts` SandboxVolumeMount[]
    - `name` string, required — Name of the volume
    - `path` string, required — Path of the volume

## Other responses

- `400` — Bad request
- `401` — Authentication error
- `500` — Server error

## Changes

- **2026-05-27** `e13ef89d456c` — 1 info
  - the endpoint scheme security `AuthProviderBearerAuth AND AuthProviderTeamAuth` was added to the API
- **2026-02-24** `0bcb69c4169b` — 1 info
  - added the optional property `items/allOf[#/components/schemas/ListedSandbox]/volumeMounts` to the response with the `200` status
- **2025-08-10** `33c54d8135e6` — 2 info
  - added the required property `items/allOf[#/components/schemas/ListedSandbox]/diskSizeMB` to the response with the `200` status
  - added the required property `items/allOf[#/components/schemas/ListedSandbox]/envdVersion` to the response with the `200` status
- **2025-07-18** `c1fe6498cb2f` — 1 info
  - response property `items/allOf[#/components/schemas/ListedSandbox]/clientID` deprecated
- **2025-05-14** `76a70174d040` — 2 info
  - added `#/components/schemas/ListedSandbox` to the `items/` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/RunningSandbox` from the `items/` response property `allOf` list for the response status `200`

[Full history](https://skmtc.dev/e2b-dev/apis/e2b-api/changes/sandboxes/get.md)

---

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