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

# List local sandboxes

`GET /local-sandbox`

Lists all active local sandbox environments owned by the user.

## Response `200`

Successful Response

- ListLocalSandboxesResponse
  - `local_sandboxes` LocalSandboxInfo[], required — List of all local sandbox environments
    - `local_sandbox_id` string, required — Unique identifier for the local sandbox environment
    - `created_at` string, required — Timestamp when the sandbox was created
    - `status` 'idle' | 'occupied' | 'error' — Status of a sandbox instance - matches database enum
    - `benchmark` string, nullable — Benchmark environment configuration for the local sandbox
    - `servers` LocalSandboxServerItem[], required — List of MCP servers in this sandbox
      - `server_name` string, nullable — Name of the MCP server
      - `id` string, required — Unique identifier for this specific server instance within the sandbox
      - `mcp_server_url` string, nullable — URL to connect to this specific MCP server instance
      - `status` 'idle' | 'occupied' | 'error' — Status of a sandbox instance - matches database enum
      - `benchmark` string, nullable — Benchmark environment configuration
      - `updated_at` string, nullable — Last update timestamp
      - `metadata` object, nullable — Additional metadata for the sandbox
      - `auth_data` object, nullable — Authentication data for the sandbox
      - `tags` string[], nullable — Sandbox tags
  - `total_count` integer, required — Total number of local sandboxes

---

[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/revisions/1f05ced7280f/schema)