# list

## Usage

```bash
bdy target exec list|ls [options] <identifier>
```

## Arguments

| **Argument** | **Description** |
| :--- | :--- |
| `identifier` | Target identifier (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 |
| `--pipeline <identifier>` | Pipeline identifier to scope the target to. Requires --project |
| `--environment <identifier>` | Environment identifier to scope the target to. Resolves a workspace environment; add --project to point at a project environment |
| `--limit <n>` | Maximum number of executions to return. Default: 50, max: 200 |
| `--format <text|json>` | Output format: json, text. Default: text |
| `-h, --help` | display help for command |

## Examples

### List executions of a target

```bash
bdy tg exec ls target-identifier
```

### List last 5 executions

```bash
bdy tg exec ls target-identifier --limit 5
```


---
Original source: https://buddy.works/docs/cli/target/exec/list