Get a sandbox (E2B)
E2B's `GET /sandboxes/{sandboxID}`. A running or paused sandbox of the project, else `404`. Never carries an envd access token.
GET
/compat/e2b/sandboxes/{sandboxID}
E2B's `GET /sandboxes/{sandboxID}`. A running or paused sandbox of the project, else `404`. Never carries an envd access token.
Authentication
Bearer Token (b3os_sk_ API key or b3os_pat_ token)
Path Parameters
sandboxID
string
required
path
The sandbox, as `sbx-<ulid>` (the `sandboxID` of the create answer) or `sbx_<ulid>`.
Responses
200
The sandbox.
application/jsonsandboxID
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, pausedallowInternetAccess
boolean
lifecycle
object
onTimeout
string
autoResume
boolean
401
Missing or invalid B3OS key in `X-API-KEY` (`unauthorized`).
404
No such live sandbox, template or file (`sandbox_not_found`, `template_not_found`, `file_not_found`).
curl -X GET 'https://beta-api.b3os.org/compat/e2b/sandboxes/string' \ -H 'Authorization: Bearer YOUR_API_TOKEN'const response = await fetch('https://beta-api.b3os.org/compat/e2b/sandboxes/string', { 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/sandboxes/string', 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", "allowInternetAccess": true, "lifecycle": { "onTimeout": "kill", "autoResume": false }}API Playground
Try this endpoint
GET
/compat/e2b/sandboxes/{sandboxID}