# tigris ls

List all buckets (no arguments) or objects under a bucket/prefix path. Accepts bare names or `t3://` URIs.

**Alias:** `list`

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

```
tigris ls [path] [flags]

t3 list [path] [flags]
```

Paths support the optional `t3://` (or `tigris://`) prefix (e.g. `t3://my-bucket/path` or just `my-bucket/path`).

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

| Name                              | Required | Default | Description                                                                                                                                                                                |
| --------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `--source`                        | No       | —       | List objects from a specific storage source on buckets with shadow migration enabled. Accepted values: `tigris` (objects already in Tigris), `shadow` (objects still on the shadow source) |
| `--snapshot-version`, `-snapshot` | No       | —       | Read from a specific bucket snapshot. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp (e.g. `1765889000501544464`)                                            |
| `--limit`                         | No       | —       | Maximum number of items to return per page                                                                                                                                                 |
| `--page-token`, `-pt`             | No       | —       | Pagination token from a previous request to fetch the next page                                                                                                                            |

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

```
# List all buckets

tigris ls



# List objects in a bucket

tigris ls my-bucket



# List objects under a prefix

tigris ls my-bucket/images/



# Using t3:// prefix

tigris ls t3://my-bucket/prefix/



# On a shadow-migrated bucket, list only objects still on the source

tigris ls my-bucket --source shadow



# Or only objects already migrated into Tigris

tigris ls my-bucket --source tigris



# List a bucket as it was in a snapshot

tigris ls my-bucket --snapshot-version 1765889000501544464



# Page through a large listing

tigris ls my-bucket --limit 100

tigris ls my-bucket --limit 100 --page-token <token-from-previous-page>
```
