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

# sqd view

> View one SQD Cloud squid deployment with the sqd CLI, select it by reference, name, slot, or tag, and optionally return JSON.

Use `sqd view` to show one squid deployed to SQD Cloud.

## Usage

```bash theme={"system"}
sqd view [--interactive] [--json] \
  [-r [<org>/]<name>(@<slot>|:<tag>) | -o <code> | -n <name> [-s <slot>] | -t <tag>]
```

| Flag                 | Description                                                                      |
| -------------------- | -------------------------------------------------------------------------------- |
| `-r, --reference`    | Fully qualified squid reference, optionally including organization, slot, or tag |
| `-n, --name`         | Squid name                                                                       |
| `-s, --slot`         | Deployment slot                                                                  |
| `-t, --tag`          | Deployment tag                                                                   |
| `-o, --org`          | Organization code                                                                |
| `--json`             | Return machine-readable JSON                                                     |
| `--[no-]interactive` | Disable interactive selection with `--no-interactive`                            |

## Examples

```bash theme={"system"}
# Select by fully qualified reference
sqd view -r acme/my-squid@green

# Select by name and return JSON
sqd view -n my-squid --json

# Resolve a deployment by tag
sqd view -t production
```

For a playground deployment, pass the generated organization code separately:

```bash theme={"system"}
sqd view \
  --org <PLAYGROUND_ORG> \
  --name my-squid \
  --slot <SLOT> \
  --json \
  --no-interactive
```

<Note>
  In `@subsquid/cli@3.3.5`, generated playground organization codes exceed the name length accepted inside `--reference`. Use separate `--org`, `--name`, and `--slot` or `--tag` flags for playground deployments.
</Note>

*See code: [src/commands/view.ts](https://github.com/subsquid/squid-cli/blob/master/src/commands/view.ts)*