# tigris stat

Show storage stats (no args), bucket info, or object metadata.

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

```
tigris stat [path]

t3 stat [path]
```

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                                                                           |
| --------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------- |
| `--format`, `-f`                  | No       | `table` | Output format. Options: `json`, `table`, `xml`                                        |
| `--snapshot-version`, `-snapshot` | No       | —       | Show metadata for a specific bucket snapshot (object paths only)                      |
| `--version-id`                    | No       | —       | Show metadata for a specific object version (requires bucket versioning, object only) |

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

```
# Show overall storage stats

tigris stat



# Show bucket info

tigris stat t3://my-bucket



# Show object metadata

tigris stat t3://my-bucket/my-object.json
```
