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

# List Schema

> List schemas

List trigger payload schemas in a workspace with pagination. Returns schema slug, name, and version info. Use `--mode` to switch between draft and live versions.

## Syntax

```bash theme={"system"}
suprsend schema list [flags]
```

## Flags

| Flag                  | Description                              | Default  |
| --------------------- | ---------------------------------------- | -------- |
| `-h, --help`          | Show help for the command                | –        |
| `-l, --limit int`     | Maximum number of schemas to return      | `20`     |
| `-m, --mode string`   | Version mode: draft or live              | `live`   |
| `-f, --offset int`    | Number of schemas to skip for pagination | `0`      |
| `-o, --output string` | Output format: pretty, json, or yaml     | `pretty` |

<Tip>
  Use `-o json` for machine-readable JSON output, `-o yaml` for YAML. Default `-o pretty` outputs a human-friendly table.
</Tip>

## Example

```bash theme={"system"}
# List schemas in staging workspace (default)
suprsend schema list

# List schemas in production workspace
suprsend schema list --workspace production

# List schemas in draft mode, with limit and offset
suprsend schema list --limit 10 --offset 5 --mode draft

# List schemas in JSON format and pipe to jq
suprsend schema list --output json | jq '.[].slug'
```