> For the complete documentation index, see [llms.txt](https://docs.cloudeka.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cloudeka.ai/cloudeka-api-list/command-reference/cldkctl-box/list.md).

# list

The box list command displays a list of object storage instances associated with your projects. This command provides details such as storage ID, name, project, region, size, billing type, status, and creation date.

## Usage

```
cldkctl box 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 box list
```

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

```
cldkctl box list --limit 5
```

3. To view a specific page of results, use the --page flag:

```
cldkctl box list --page 2
```

4. Once executed, the command will display a table containing all object storage instances under your account.

<figure><img src="/files/gbKaFrGdxj6GG3H5FLQj" alt=""><figcaption></figcaption></figure>

| Column       | Description                                         |
| ------------ | --------------------------------------------------- |
| ID           | Unique identifier for each object storage instance. |
| Name         | Name of the object storage.                         |
| Project      | Associated project name.                            |
| Region       | Geographical region of the object storage.          |
| Size         | Allocated capacity of the storage.                  |
| Billing Type | Type of billing plan.                               |
| Status       | Current state of the object storage.                |
| Created Date | Date when the object storage instance was created   |

## Flags

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

| Flag               | Description                         |
| ------------------ | ----------------------------------- |
| -h, --help         | Help for box list command.          |
| -l, --limit string | Specify number of results per page. |
| -p, --page string  | Specify page number.                |