List Sandboxes

GET/sandboxes

List sandboxes for your organization, optionally filtered by status. E2B-compatible: returns a JSON array of sandbox objects directly (no wrapper).

Query Parameters

Parameter	Type	Description
status	string	Filter by status: running, paused, stopped, creating, error. Omit to list all.

Example

curl "https://api.sandbase.ai/sandboxes?status=running" \
  -H "Authorization: Bearer sk-sb-YOUR_KEY"

Response

[
  {
    "sandboxID": "sbx_01abc...",
    "templateID": "code_interpreter",
    "clientID": "erouter",
    "status": "running",
    "metadata": {},
    "startedAt": "2026-05-24T10:00:00Z",
    "endAt": "2026-05-24T10:05:00Z"
  }
]

See the sandbox object for field descriptions.

Errors

Status	Message
400	invalid status filter: <value>

Roadmap

Metadata-based filtering (?metadata=user=abc&app=prod) and cursor pagination (E2B's GET /v2/sandboxes) are on the roadmap.