> ## 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 Event

> List events

List all events in a workspace with pagination. Returns event names and their linked schema information.

## Syntax

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

## Flags

| Flag                  | Description                              | Default  |
| --------------------- | ---------------------------------------- | -------- |
| `-h, --help`          | Show help for the command                | –        |
| `-l, --limit int`     | Maximum number of events to return       | `20`     |
| `-f, --offset int`    | Number of events to skip for pagination  | `0`      |
| `-o, --output string` | Output format (`pretty`, `json`, `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 events in staging workspace (default)
suprsend event list

# List events in production workspace
suprsend event list --workspace production

# List events with limit and offset
suprsend event list --limit 10 --offset 5

# List events in JSON format
suprsend event list --output json
```