Command-line tool and TypeScript library

fragdenstaat

A command-line client and TypeScript library for the public, read-only API of FragDenStaat.de — Germany’s central Freedom-of-Information (Informationsfreiheit) portal, run by the Open Knowledge Foundation Deutschland.

Version 0.0.8 npm GitHub API reference

Install

Needs Node.js 20 or newer. Installs the fragdenstaat command:

npm i -g @maschinenlesbar.org/fragdenstaat-cli

Access

No account, no API key, no configuration — install and query.

Quick start

# Find FOI requests about a topic (full-text search)
fragdenstaat request search --q "Videoüberwachung" --limit 5

# Filter requests: resolved & successful, federal jurisdiction
fragdenstaat request list --status resolved --resolution successful --jurisdiction 1 --limit 10

# One request in full, including its message thread
fragdenstaat request get 374948

# Which authority handles a topic? (name -> id, then profile)
fragdenstaat publicbody autocomplete "Umweltbundesamt"
fragdenstaat publicbody get 1

# Which FOI law applies in a jurisdiction?
fragdenstaat jurisdiction list
fragdenstaat law list --jurisdiction 1 --q umwelt

# Export a dataset to CSV
fragdenstaat request list --status resolved --jurisdiction 1 --csv -o requests.csv

Commands

All commands, arguments and options →

Claude Code skills

The fragdenstaat plugin teaches Claude to use fragdenstaat. Install it from the maschinenlesbar.org marketplace:

/plugin marketplace add maschinenlesbar-org/plugins
/plugin install fragdenstaat@maschinenlesbar

TypeScript library

@maschinenlesbar.org/fragdenstaat-cli is also a typed API client you can import in your own code, with no runtime HTTP dependencies.

The tool, not the data

The data comes from the provider behind the API, under its own terms — see DATA_LICENSE.md. The code is dual-licensed AGPL-3.0-or-later or commercial — see LICENSING.md.