# list

The dns list command lists all DNS zones associated with a project. This command provides details such as the zone ID, name, status, and creation date.

## Usage

```
cldkctl dns list [flags]
```

## Aliases

```
list, ls
```

## Steps

Follow the steps below to run and view the result of this command:

1. Run the following command in your terminal:

```
cldkctl dns list
```

2. To limit the number of displayed results, specify the limit flag:

```
cldkctl dns list --limit [number]
```

3. To filter the result by DNS zone name, use the name flag:

```
cldkctl dns list --name [dns-zone-name]
```

4. To view additional results, use the page flag:

```
cldkctl dns list --page [page-number]
```

5. The terminal displays a list of DNS zones in a table format, showing information such as ID, domain name, status, and creation date.

<figure><img src="https://2882153758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fi9YWb69HFXLHYlXffReU%2Fuploads%2FU0IrYmt5IktHZXcLREtO%2Funknown.png?alt=media&#x26;token=28096d5a-387f-4cee-9feb-8bdea9047ef2" alt=""><figcaption></figcaption></figure>

| Column     | Description                                           |
| ---------- | ----------------------------------------------------- |
| ID         | Unique identifier of the DNS zone.                    |
| Name       | Domain name of the DNS zone.                          |
| Status     | Indicates whether the DNS zone is active or inactive. |
| Created At | Timestamp showing when the DNS zone was created.      |

## Flags

{% hint style="info" %}
This command supports [global flags](https://docs.cloudeka.ai/cloudeka-api-list/global-flags). Refer to the Global Flags section for details.
{% endhint %}

| Flag               | Description                                        |
| ------------------ | -------------------------------------------------- |
| -h, --help         | Help for dns list command.                         |
| -l, --limit string | Specify number of results per page (default "10"). |
| -n, --name string  | Filter by DNS zone name.                           |
| -p, --page string  | Specify page number (default "1")                  |