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

# Transactions

> List transactions with optional filters for status, type, and pagination.

## List transactions

```bash theme={null}
veil transactions list
```

Prints one line per transaction: ID, type, status, amount in, and amount out.

## Flags

| Flag                        | Description                                              |
| --------------------------- | -------------------------------------------------------- |
| `--status <status>`         | Filter by status (e.g. `pending`, `completed`, `failed`) |
| `--type <offramp\|deposit>` | Filter by transaction type                               |
| `--limit <1-100>`           | Maximum number of results (default: API default)         |
| `--offset <n>`              | Skip the first `n` results for pagination                |
| `--live`                    | List production transactions                             |

## Pagination

When a result set has more pages, the CLI prints a summary line:

```
Total: 250 | Limit: 20 | Offset: 0 | Has more: true
```

Retrieve the next page with `--offset`:

```bash theme={null}
veil transactions list --limit 20 --offset 20
```
