# tigris objects list-versions

List object versions and delete markers in a bucket. Requires bucket versioning to be enabled. Returns versions and delete markers as two separate arrays to match the S3 `ListObjectVersions` response.

**Alias:** `lv`

## Usage[​](#usage "Direct link to Usage")

```
tigris objects list-versions <bucket> [flags]

t3 o lv <bucket> [flags]
```

The bucket argument also accepts a `t3://bucket/prefix/` path; the prefix is applied automatically.

## Flags[​](#flags "Direct link to Flags")

| Name                  | Required | Default | Description                                                                                   |
| --------------------- | -------- | ------- | --------------------------------------------------------------------------------------------- |
| `--prefix`, `-p`      | No       | —       | Filter by key prefix                                                                          |
| `--delimiter`, `-d`   | No       | —       | Group keys sharing a common prefix up to the delimiter (e.g. `/` for folder-style)            |
| `--format`            | No       | `table` | Output format. Options: `json`, `table`, `xml`                                                |
| `--limit`             | No       | —       | Maximum number of items to return per page                                                    |
| `--key-marker`        | No       | —       | Pagination marker — the key to start listing from (from a prior `nextKeyMarker`)              |
| `--version-id-marker` | No       | —       | Pagination marker — the version id to start listing from (from a prior `nextVersionIdMarker`) |

## Examples[​](#examples "Direct link to Examples")

```
# List all versions in a bucket

tigris objects list-versions my-bucket



# Scope to a path with a t3:// URI

tigris objects list-versions t3://my-bucket/logs/



# Filter by prefix

tigris objects list-versions my-bucket --prefix images/



# JSON output (suitable for jq)

tigris objects list-versions my-bucket --format json
```

## Output shape[​](#output-shape "Direct link to Output shape")

The `json` and `xml` outputs always emit valid empty arrays when there are no results, so consumers don't have to special-case the empty case:

```
{

  "versions": [

    {

      "name": "report.pdf",

      "versionId": "abc123",

      "isLatest": true,

      "size": 1024,

      "lastModified": "..."

    }

  ],

  "deleteMarkers": [

    {

      "name": "old.txt",

      "versionId": "def456",

      "isLatest": true,

      "lastModified": "..."

    }

  ],

  "commonPrefixes": [],

  "nextKeyMarker": null,

  "nextVersionIdMarker": null,

  "hasMore": false

}
```

When the result set is paginated, the table-format output prints a hint with the `--key-marker` and `--version-id-marker` values needed for the next page.