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

# list-domains

> List custom domains across your workspace

List your custom domains with their verification status and DNS records. Filter by project, app, or environment using IDs or slugs, or omit all three filters to list domains across your workspace.

Use any filter independently or combine filters. Results match all supplied filters.

## Usage

```bash theme={"theme":"kanagawa-wave"}
unkey api domains list-domains [flags]
```

## Flags

<ParamField body="--project" type="string">Match a project ID or slug. This filter doesn't require an app or environment filter.</ParamField>
<ParamField body="--app" type="string">Match an app ID or slug. This filter doesn't require a project or environment filter.</ParamField>
<ParamField body="--environment" type="string">Match an environment ID or slug. This filter doesn't require a project or app filter.</ParamField>
<ParamField body="--limit" type="integer" default="100">Maximum domains per response, from 1 to 100.</ParamField>
<ParamField body="--cursor" type="string">Cursor returned by the previous page when `hasMore` is true.</ParamField>
<ParamField body="--search" type="string">Case-insensitive filter matching domain IDs or names.</ParamField>

## Global Flags

| Flag         | Type   | Description                                                                                   |
| ------------ | ------ | --------------------------------------------------------------------------------------------- |
| `--root-key` | string | Override root key (`$UNKEY_ROOT_KEY`)                                                         |
| `--api-url`  | string | Override API base URL (default: `https://api.unkey.com`)                                      |
| `--config`   | string | Path to config file (default: `~/.unkey/config.toml`)                                         |
| `--output`   | string | Output format. Use `json` for raw JSON                                                        |
| `--body`     | string | Send this JSON string as the request body. You cannot combine it with request-building flags. |

## Examples

```bash theme={"theme":"kanagawa-wave"}
unkey api domains list-domains --app=api --limit=25 --search=acme.com
```

See [Custom domains](/docs/networking/domains) for DNS and verification details.