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

# nodes list

> List workspace nodes

<Note>
  This command is marked as unstable and may change in future releases.
</Note>

## Command: `phala nodes list`

### Syntax

```
phala nodes list [options]
```

### Description

List workspace nodes

### Options

| Option                | Description              |
| --------------------- | ------------------------ |
| `--page <value>`      | Page number (1-based)    |
| `--page-size <value>` | Number of items per page |

### Global Options

| Option                               | Description                                                  |
| ------------------------------------ | ------------------------------------------------------------ |
| `-h, --help`                         | Show help information for the current command                |
| `-v, --version`                      | Show CLI version                                             |
| `--api-token TOKEN, --api-key TOKEN` | API token for authenticating with Phala Cloud                |
| `-j, --json, --no-json`              | Output in JSON format                                        |
| `--interactive`                      | Enable interactive mode for commands that support it         |
| `--cvm-id <value>`                   | CVM identifier (UUID, app\_id, instance\_id, or name)        |
| `--profile PROFILE`                  | Temporarily use a different auth profile for this command    |
| `--api-version <value>`              | API version to use (e.g. 2026-01-21, 2026-05-22, 2026-06-23) |
| `--timeout SECONDS`                  | Request timeout in seconds (default 60)                      |

### Examples

* List nodes (page 1)

```bash theme={"system"}
phala nodes list
```

* List nodes (page 2)

```bash theme={"system"}
phala nodes list --page 2
```

* Output as JSON

```bash theme={"system"}
phala nodes list --json
```