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

# modus scopes list

> List scopes in the authenticated organization.

List scopes in the authenticated organization.

## Usage

```bash theme={null}
modus scopes list [flags]
```

## Flags

| Flag           | Type   | Description                                 |
| -------------- | ------ | ------------------------------------------- |
| `--search`     | string | Filter by search term.                      |
| `--page-size`  | string | Items per page (default 25, max 100).       |
| `--page-token` | string | Opaque page token from a previous response. |

Global: `--pretty` — human-readable table output instead of compact JSON.

## Examples

```bash theme={null}
modus scopes list
modus scopes list --pretty
modus scopes list --search revenue
```

See [CLI quickstart](/guides/cli) for install and auth.