# tigris objects list

List objects in a bucket, optionally filtered by a key prefix.

**Alias:** `l`

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

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

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

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

| Name             | Required | Default | Description                                                       |
| ---------------- | -------- | ------- | ----------------------------------------------------------------- |
| `--prefix`, `-p` | No       | —       | Filter objects by key prefix (e.g. "images/" to list only images) |
| `--format`, `-f` | No       | `table` | Output format. Options: `json`, `table`, `xml`                    |

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

```
tigris objects list my-bucket

tigris objects list my-bucket --prefix images/

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