Introduction

altoviz is a self-contained command-line interface that wraps the Altoviz REST API. It lets you manage customers, suppliers, invoices, quotes, products, receipts, and more — directly from the terminal or from an LLM agent.

Key highlights:

• No runtime required — single binary for macOS, Linux, and Windows
• 9 output formats — table (default), JSON, YAML, Markdown, CSV, TSV
• Shell completions — bash, zsh, fish, PowerShell
• Flexible auth — env var, config file, or --api-key flag
• Scriptable — pipe JSON in with --file -, control columns with --columns, page with --all-pages

Quick start

# Store your API key
altoviz configure

# — or pass it via environment variable
export ALTOVIZ_CLI_API_KEY=your_key_here

# Verify connectivity
altoviz hello

# List invoices
altoviz invoice list

# Fetch a single customer as JSON
altoviz customer get 42 --output json

# Export this year's invoices to CSV
altoviz export invoices --from 2026-01-01 --to 2026-12-31

Next

• Installation
• Configuration
• Commands
• Reference

Any question?

If you have any question regarding the CLI, feel free to contact us by chat or by email.