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

# Get Sandbox Status

> Lightweight check of whether a sandbox is currently running.

Returns a single boolean `is_running` field. Use this endpoint for lightweight
polling when you only need to know if the sandbox is alive, without fetching the
full sandbox object.

`is_running` is `true` only when the sandbox state is `running`. It is `false`
for `creating`, `paused`, and `killed` states.

## Path Parameters

<ParamField path="sandbox_id" type="string" required>
  The sandbox identifier. Format: `sbx-<8 chars>`.
</ParamField>

## Response

<ResponseField name="is_running" type="boolean">
  `true` if the sandbox is in the `running` state, `false` otherwise.
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.declaw.ai/sandboxes/sbx-a1b2c3d4/status \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  resp = requests.get(
      "https://api.declaw.ai/sandboxes/sbx-a1b2c3d4/status",
      headers={"X-API-Key": "YOUR_API_KEY"},
  )
  print(resp.json()["is_running"])  # True
  ```
</CodeGroup>

```json Response (running) theme={null}
{
  "is_running": true
}
```

```json Response (paused or killed) theme={null}
{
  "is_running": false
}
```

## Error Responses

| Status | Cause                      |
| ------ | -------------------------- |
| `401`  | Missing or invalid API key |
| `404`  | Sandbox not found          |