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

# Commands

> Complete reference for all Nordic Financial News CLI commands.

## Articles

```bash theme={"dark"}
nfn articles list                 # list recent articles
nfn articles list --limit 5      # limit results
nfn articles list --country SE   # filter by country
nfn articles list --category "Earnings & Financial Results"
nfn articles list --ticker VOLV-B
nfn articles get <id>            # fetch a specific article
```

## Stories

```bash theme={"dark"}
nfn stories list                  # list recent stories
nfn stories get <id>              # fetch a specific story
```

## Calendar events

```bash theme={"dark"}
nfn calendar list                          # upcoming calendar events
nfn calendar list --ticker VOLV-B          # filter by company
nfn calendar list --event-type earnings_report,dividend
nfn calendar list --country SE --status scheduled
nfn calendar list --updated-after 2026-03-01T00:00:00Z   # incremental sync
nfn calendar get <id>                      # fetch a specific event
```

Filter flags: `--ticker`, `--company`, `--country`, `--exchange`, `--index`, `--sector`, `--event-type`, `--status`, `--scheduled-after`, `--scheduled-before`, `--updated-after`, `--watchlist-id`.

## Companies

```bash theme={"dark"}
nfn companies list                       # list all companies
nfn companies get <identifier>           # look up by ID or ticker
nfn companies articles <identifier>      # articles for a company
nfn companies stories <identifier>       # stories for a company
```

## Search

```bash theme={"dark"}
nfn search "Volvo"
```

## Exchanges and indices

```bash theme={"dark"}
nfn exchanges list                       # list exchanges
nfn exchanges get <mic>                  # exchange details by MIC code
nfn exchanges companies <mic>            # companies on an exchange

nfn indices list                         # list indices
nfn indices get <symbol>                 # index details
nfn indices companies <symbol>           # companies in an index
```

## Reference data

```bash theme={"dark"}
nfn categories                           # list article categories
nfn countries list                       # list supported countries
nfn countries get <code>                 # country details by ISO code
```

## Watchlists

```bash theme={"dark"}
nfn watchlists list                      # list your watchlists
nfn watchlists get <id>                  # get a specific watchlist
```

## Utilities

```bash theme={"dark"}
nfn doctor                               # verify system health
nfn version                              # display CLI version
nfn commands                             # JSON catalog of all commands
```

## Output formatting

The CLI automatically detects your environment:

* **Interactive terminal**: formatted tables
* **Piped or scripted**: JSON output

Override the default with `--format`:

```bash theme={"dark"}
nfn articles list --format json
nfn articles list --format table
```

### Pipe to other tools

Because the CLI outputs JSON when piped, you can combine it with tools like `jq`:

```bash theme={"dark"}
nfn articles list --limit 10 | jq '.data.articles[].title'
```

## Get help

Every command has built-in help:

```bash theme={"dark"}
nfn --help
nfn articles --help
nfn articles list --help
```

For bugs and feature requests, open an issue on [GitHub](https://github.com/nordic-financial-news/nfn-cli/issues).