List sandboxes (E2B)
E2B's `GET /v2/sandboxes`. Running and paused sandboxes of the project, newest first, filtered by `metadata` (URL-encoded `key=value` pairs joined with `&`, at most 4) and `state` (`running`, `paused`, comma-separated). Pages hold `limit` sandboxes (default 100, at most 100); the next page's token is the `x-next-token` response header. Never carries an envd access token.
GET
/compat/e2b/v2/sandboxes
E2B's `GET /v2/sandboxes`. Running and paused sandboxes of the project, newest first, filtered by `metadata` (URL-encoded `key=value` pairs joined with `&`, at most 4) and `state` (`running`, `paused`, comma-separated). Pages hold `limit` sandboxes (default 100, at most 100); the next page's token is the `x-next-token` response header. Never carries an envd access token.
Authentication
Bearer Token (b3os_sk_ API key or b3os_pat_ token)
Query Parameters
metadata
string
optional
query
URL-encoded `key=value` pairs joined with `&`.
state
string
optional
query
`running`, `paused`, or both comma-separated (the default).
limit
integer
optional
query
nextToken
string
optional
query
The `x-next-token` header of the previous page.
Responses
200
One page of sandboxes.
application/json
Array of:
sandboxID
string
REQUIRED
templateID
string
REQUIRED
clientID
string
REQUIRED
startedAt
string (date-time)
REQUIRED
endAt
string (date-time)
REQUIRED
cpuCount
integer
REQUIRED
memoryMB
integer
REQUIRED
diskSizeMB
integer
REQUIRED
envdVersion
string
REQUIRED
metadata
object
state
string
REQUIRED
Enum:
running, paused
400
A malformed value, or an option B3OS cannot honor named in the message (`invalid_request`, `unsupported_option`).
401
Missing or invalid B3OS key in `X-API-KEY` (`unauthorized`).
curl -X GET 'https://beta-api.b3os.org/compat/e2b/v2/sandboxes' \ -H 'Authorization: Bearer YOUR_API_TOKEN'const response = await fetch('https://beta-api.b3os.org/compat/e2b/v2/sandboxes', { method: 'GET', headers: { "Authorization": "Bearer YOUR_API_TOKEN" }});const data = await response.json();console.log(data);import requestsheaders = { 'Authorization': 'Bearer YOUR_API_TOKEN'}response = requests.get('https://beta-api.b3os.org/compat/e2b/v2/sandboxes', headers=headers)print(response.json())
200
Response
[ { "sandboxID": "sbx-01m5t68q1b590rj801nbzsqzkk", "templateID": "base", "clientID": "b3os", "startedAt": "2026-11-02T13:00:00.000Z", "endAt": "2026-11-02T13:05:00.000Z", "cpuCount": 1, "memoryMB": 512, "diskSizeMB": 4096, "envdVersion": "0.5.7", "metadata": { "run": "demo" }, "state": "running" }]API Playground
Try this endpoint
GET
/compat/e2b/v2/sandboxes