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

# Browse the domain inventory

> List apex domains and hosts with discovery, lifecycle, DNS, and web status filters.

Use `tolmo domains list` to inspect your organization's canonical domain inventory. By default, it lists apex domains with host counts and probe summaries.

```bash theme={null}
tolmo domains list
tolmo domains list --q api --lifecycle current
tolmo domains list --apex example.com --page 1 --limit 50 --json
```

Pass `--apex` to list individual hosts under one apex domain. JSON output includes `items`, `page`, `limit`, `total`, and `totalPages`.

## Filters and pagination

| Flag | Values or behavior |
| - | - |
| `--q` | FQDN or apex substring |
| `--apex` | List hosts under this apex instead of apex summaries |
| `--lifecycle` | `current`, `stale`, or `historical` |
| `--dns` | `resolved`, `unresolved`, `error`, or `not_checked` |
| `--web` | `reachable`, `unreachable`, `blocked`, or `not_checked` |
| `--source` | Discovery source, such as `cert_spotter` |
| `--page` | One-based page number; defaults to `1` |
| `--limit` | Page size from `1` to `100`; defaults to `50` |

Each command returns one page. Increase `--page` to read more results. The [domain export endpoint](/api-reference/domains/export-the-domain-inventory) provides a CSV or JSON export through the REST API.

For website crawl records and scan history, see [Website and organization commands](/features/website-org).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.