# list

## Usage

```bash
bdy artifact version list|ls [options] <identifier>
```

## Arguments

| **Argument** | **Description** |
| :--- | :--- |
| `identifier` | Artifact identifier (human-readable) (required) |

## Options

| **Option** | **Description** |
| :--- | :--- |
| `-w, --workspace <domain>` | Workspace URL handle. Can be set via variable: BUDDY_WORKSPACE |
| `-p, --project <name>` | Project name. Can be set via variable: BUDDY_PROJECT |
| `--page <number>` | Page number. Default: 1 (default: "1") |
| `--per-page <number>` | Items per page. Default: 10 (default: "10") |
| `-h, --help` | display help for command |

## Examples

### List artifact versions

```bash
bdy art ver ls artifact-identifier
```

### List 20 artifact versions from page 2

```bash
bdy art ver ls artifact-identifier --page 2 --per-page 20
```


---
Original source: https://buddy.works/docs/cli/artifact/version/list