> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vers.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Repo tag get

# vers repo tag get

Print detailed information about a single tag: its ID, reference, the commit it points at, and timestamps.

## Synopsis

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo tag get <repo-name> <tag-name>
vers repo tag get <repo-name> <tag-name> --format json
```

## Options

| Option     | Description           |
| ---------- | --------------------- |
| `--format` | Output format: `json` |

## Examples

### Default output

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo tag get my-app latest
# Tag:         latest
# Tag ID:      …
# Reference:   my-app:latest
# Commit:      c7e4a2f1-1234-5678-9abc-def012345678
# Created:     2026-04-18 14:02:10
# Updated:     2026-04-20 09:14:22
# Description: Current main build
```

### JSON

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo tag get my-app latest --format json
```

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "tag_id": "…",
  "tag_name": "latest",
  "reference": "my-app:latest",
  "commit_id": "c7e4a2f1-…",
  "created_at": "2026-04-18T14:02:10Z",
  "updated_at": "2026-04-20T09:14:22Z",
  "description": "Current main build"
}
```

### Resolving a ref to a commit ID

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
COMMIT=$(vers repo tag get my-app latest --format json | jq -r .commit_id)
```

For most uses you'd just pass the ref directly to `vers run-commit my-app:latest --ref`. Resolving to a raw commit ID is useful when you want to pin the exact commit in a script or config (refs move, commits don't).

## Error Cases

### Repository or tag not found

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
vers repo tag get ghost latest
# Error: Repository or tag not found

vers repo tag get my-app ghost
# Error: Repository or tag not found
```

## See Also

* [`vers repo tag list`](/cli-reference/repo-tag-list)
* [`vers repo tag update`](/cli-reference/repo-tag-update)
* [`vers run-commit`](/cli-reference/run-commit)