# vhsm list

The `vhsm list` command retrieves a list of data or secerts from vHSM at a specified path. It is a wrapper around the HTTP `LIST` method and is typically used to list keys in a secrets engine.

***

### **Usage**

```sh
vhsm list [options] <PATH>
```

* `<PATH>`: The vHSM path where data should be listed.

{% hint style="info" %}
**Note:** Not all secret engines support listing. Refer to the specific engine's documentation for more details.
{% endhint %}

***

### **Example**

This command lists all metadata under the secret folder.

```sh
vhsm list secret/metadata/
```

**Output**

```
Keys
----
my-app/
```

Each key represents a stored metadata.

***

### **Options**

#### **HTTP Options**

| Option                 | Description                                                                                  |
| ---------------------- | -------------------------------------------------------------------------------------------- |
| `-address=<string>`    | Address of the vHSM server. Default: `https://127.0.0.1:8200` (can be set via `VAULT_ADDR`). |
| `-namespace=<string>`  | Namespace for the command (`VAULT_NAMESPACE`).                                               |
| `-tls-skip-verify`     | Disables TLS certificate verification (not recommended, `VAULT_SKIP_VERIFY`).                |
| `-wrap-ttl=<duration>` | Wraps response in a cubbyhole token (e.g., `30s`, `5m`, `VAULT_WRAP_TTL`).                   |

#### **Output Options**

| Option             | Description                                                                          |
| ------------------ | ------------------------------------------------------------------------------------ |
| `-format=<string>` | Output format: `table`, `json`, `yaml`, `pretty`. Default: `table` (`VAULT_FORMAT`). |