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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cloudeka.ai/cloudeka-api-list/command-reference/cldkctl-box/list.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.