# metalcloud-cli site list

List all sites with their basic information

## Synopsis

List all sites (datacenters) available in the system with their basic information.

This command displays a table containing site details including ID, name, label, status,
and creation date. Sites are physical datacenters or locations where infrastructure
is deployed.

Required Permissions:
  sites:read - Permission to view site information

Optional Flags:
  Common output flags are available (--format, --output, etc.)

Examples:
  ## List all sites in table format
  metalcloud-cli site list

  ## List sites with JSON output
  metalcloud-cli site list --format json

  ## List sites with custom output format
  metalcloud-cli site list --output "{{.ID}} {{.Label}}"

```
metalcloud-cli site list [flags...] [flags]
```

### Options

```
  -h, --help   help for list
```

### Options inherited from parent commands

```
  -k, --api_key string         MetalCloud API key
  -c, --config string          Config file path
  -d, --debug                  Set to enable debug logging
  -e, --endpoint string        MetalCloud API endpoint
  -f, --format string          Output format. Supported values are 'text','csv','md','json','yaml'. (default "text")
  -i, --insecure_skip_verify   Set to allow insecure transport
  -l, --log_file string        Log file path
  -v, --verbosity string       Log level verbosity (default "INFO")
```

### SEE ALSO

* [metalcloud-cli site](/content/configuration/cli/metalcloud-cli_site.md)	 - Manage sites (datacenters) and their configurations

#### Auto generated by spf13/cobra on 11-Aug-2025