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

# List all sandboxes

`GET /sandbox`

Get all sandboxes associated with the API key's account. Optionally filter by tag.

## Query parameters

- `tag` string, nullable — Optional sandbox tag string to filter by
- `server_name` string, nullable — Optional MCP server name to filter by (case-insensitive)

## Response `200`

Successful Response

- ListSandboxesResponse — Response model for listing all sandboxes
  - `sandboxes` SandboxListItem[], required — List of sandboxes
    - `sandbox_id` string, required — Unique identifier for the sandbox
    - `server_name` string, required — The MCP server name
    - `status` 'idle' | 'occupied' | 'error', required — Status of a sandbox instance - matches database enum
    - `benchmark` string, nullable — Benchmark for the sandbox initial environment
    - `tags` string[], nullable — Sandbox tags
    - `updated_at` string, date-time, nullable — Last update timestamp
  - `total_count` integer, required — Total number of sandboxes

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/klavis-ai/apis/klavis-ai-https-www-klavis-ai.md) · [All operations](https://skmtc.net/klavis-ai/apis/klavis-ai-https-www-klavis-ai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/klavis-ai/klavis-ai-https-www-klavis-ai/versions/1f05ced7280f/schema)