> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runtools.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Sandbox

> Get details for one sandbox

## Path Parameters

<ParamField path="id" type="string" required>
  Sandbox ID or sandbox name.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Sandbox identifier.
</ResponseField>

<ResponseField name="name" type="string">
  Optional sandbox name.
</ResponseField>

<ResponseField name="status" type="string">
  Current status, such as `pending`, `creating`, `running`, `pausing`, `paused`, `resuming`, `destroying`, `destroyed`, or `failed`.
</ResponseField>

<ResponseField name="template" type="string">
  Template used by the sandbox.
</ResponseField>

<ResponseField name="sshReady" type="boolean">
  Whether SSH is ready.
</ResponseField>

<ResponseField name="vncReady" type="boolean">
  Whether desktop access is ready.
</ResponseField>

<ResponseField name="vncUrl" type="string">
  Browser desktop URL for desktop templates when available.
</ResponseField>

<ResponseField name="mounts" type="array">
  Workspace mounts attached to the sandbox.
</ResponseField>

<ResponseField name="hasWritableWorkspaceMount" type="boolean">
  Whether the sandbox has a writable workspace mount.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.runtools.ai/v1/sandboxes/sandbox-abc123 \
    -H "X-API-Key: $RUNTOOLS_API_KEY"
  ```

  ```typescript SDK theme={null}
  const sandbox = rt.sandbox.get('sandbox-abc123');
  sandbox.on('status', (state) => console.log(state.status));
  await sandbox.waitForReady();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": {
      "id": "sandbox-abc123",
      "name": "build-runner",
      "status": "running",
      "template": "base-ubuntu",
      "sshReady": true,
      "vncReady": false,
      "mounts": [
        {
          "workspaceId": "9b84ef42-9c3a-4930-9d4c-45c7f5c22d8e",
          "path": "/workspace"
        }
      ],
      "hasWritableWorkspaceMount": true,
      "tags": ["ci"],
      "createdAt": "2026-05-06T10:00:00Z"
    }
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": {
      "code": "not_found",
      "message": "Sandbox not found"
    }
  }
  ```
</ResponseExample>