# List sandboxes - Documentation

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown is available with `Accept: text/markdown` and `.md` URL variants.

Source: /docs/guides/sandbox-cli-list-sandboxes

# List sandboxes

###

[​](#list-all-running-sandboxes)

List all running sandboxes

To list all running sandboxes, use the following command:

Bash

```
novita-sandbox-cli sandbox list
```

###

[​](#filter-by-state)

Filter by state

Use the `--state` flag to filter sandboxes by state. Supported values are “running”, “paused”, or both.
For example, to get both running and paused sandboxes:

Bash

```
novita-sandbox-cli sandbox list --state running,paused
```

###

[​](#filter-by-metadata)

Filter by metadata

Use the `--metadata` flag to filter sandboxes by metadata.

Bash

```
novita-sandbox-cli sandbox list --metadata key1=value1,key2=value2
```

###

[​](#list-limit)

List limit

Use the `--limit` flag to limit the number of sandboxes returned by the command.
If the `--limit` flag is not specified, the command returns all sandboxes.

Bash

```
novita-sandbox-cli sandbox list --limit 10
```

Last modified on June 24, 2026