> ## 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 usage list-users

> List distinct acting-user emails present in your organization's usage over a time window.

List distinct acting-user emails present in your organization's usage over a time window.

## Usage

```bash theme={null}
modus usage list-users [flags]
```

## Flags

| Flag      | Type   | Description                   |
| --------- | ------ | ----------------------------- |
| `--since` | string | ISO-8601 start of the window. |
| `--until` | string | ISO-8601 end of the window.   |

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

## Examples

```bash theme={null}
modus usage list-users --since 2026-07-01T00:00:00Z --until 2026-07-25T00:00:00Z
```

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