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

> Report token/run usage over a time window, rolled up by hour or day.

Report token/run usage over a time window, rolled up by hour or day.

## Usage

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

## Flags

| Flag           | Type   | Description                               |
| -------------- | ------ | ----------------------------------------- |
| `--since`      | string | ISO-8601 start of the window.             |
| `--until`      | string | ISO-8601 end of the window.               |
| `--rollup`     | string | Bucket size. (default: `day`)             |
| `--model`      | string | Filter by model identifier.               |
| `--user-email` | string | Filter by acting-user email (repeatable). |

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

## Examples

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

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