# tuist build once list

Lists the Once runs of a project, newest first.

## Arguments

### project `Optional`

The full handle of the project. Must be in the format of account-handle/project-handle.

```bash
tuist build once list --project [project]
tuist build once list -P [project]
```

### path `Optional`

The path to the directory or a subdirectory of the project.

```bash
tuist build once list --path [path]
tuist build once list -p [path]
```

### kind `Optional`

Filter runs by kind (build, test, or generic).

```bash
tuist build once list --kind [kind]
```

### status `Optional`

Filter runs by status (success or failure).

```bash
tuist build once list --status [status]
```

### git-branch `Optional`

Filter runs by git branch.

```bash
tuist build once list --git-branch [git-branch]
```

### page `Optional`

The page number to fetch (1-indexed).

```bash
tuist build once list --page [page]
```

### page-size `Optional`

The number of runs per page. Defaults to 10.

```bash
tuist build once list --page-size [page-size]
```

### json `Optional`

The output in JSON format.

```bash
tuist build once list --json
```