---
title: "List sandboxes (v2)"
method: GET
path: "/v2/sandboxes"
tags: ["sandboxes"]
---

# List sandboxes (v2)

`GET /v2/sandboxes`

List all sandboxes

## Query parameters

- `metadata` string
- `state` SandboxState[]
- `order` 'asc' | 'desc' — Sort direction
- `startedAfter` string, date-time
- `template` string
- `nextToken` string
- `limit` integer

## 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

> 53 revisions in range; 3 could not be searched.

- **2026-07-24** `93ed246a4c10` — 16 info
  - the endpoint scheme security `AdminApiKeyAuth AND AdminTeamAuth` was added to the API
  - the endpoint scheme security `Supabase1TokenAuth AND Supabase2TeamAuth` was removed from the API
  - added the optional property `items/alias` to the response with the `200` status
  - added the optional property `items/metadata` to the response with the `200` status
  - …12 more
- **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-11-15** `9fdd20bda2bb` — 1 warning
  - for the `query` request parameter `limit`, the max was set to `100.00`
- **2025-08-21** `018224fe7238` — 1 breaking
  - for the `query` request parameter `limit`, default value was changed from `1000` to `100`

[Full history](https://skmtc.dev/e2b-dev/apis/e2b-api/changes/v2/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/e01b3f5506fe/schema)