Command-line tool and TypeScript library

`fit-connect`

Find out which German authority is responsible for a public administrative service in a given place — straight from your terminal. fit-connect is a command-line tool over the open FIT-Connect Routing API (routing-api-prod.fit-connect.fitko.net) operated by the FITKO (Föderale IT-Kooperation).

Version 0.0.6 npm GitHub API reference

Install

Needs Node.js 20 or newer. Installs the fit-connect command:

npm i -g @maschinenlesbar.org/fit-connect-cli

Access

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

Quick start

# 1. Resolve a place to an area id
fit-connect areas Hanau

# 2. Route a service key into that area to find the responsible authority
#    (99123456760610 is an illustrative key with no registered destinations,
#     so these examples return an empty `routes: []` — that is normal, see below)
fit-connect routes 99123456760610 --area-id 940

# Already have the official codes? Skip step 1 (here: Erfurt, by Regionalschlüssel):
fit-connect routes 99123456760610 --ars 160510000000

Commands

routes

Find the responsible authority (Zustellpunkt) for a public service in an area. Provide exactly one area selector: --ags, --ars or --area-id.
areas

Search areas by name and/or postal code. Supports the `*` wildcard, e.g. `areas "Mag*"`. Terms are split into words on spaces and punctuation, and every word must match the same area. Use a result's id as --area-id for `fit-connect routes`.
info

Show the version of the deployed Routing API instance

All commands, arguments and options →

Claude Code skills

The fit-connect plugin teaches Claude to use fit-connect. Install it from the maschinenlesbar.org marketplace:

/plugin marketplace add maschinenlesbar-org/plugins
/plugin install fit-connect@maschinenlesbar

/fit-connect:fit-connect-area-lookup
/fit-connect:fit-connect-find-authority
/fit-connect:fit-connect-service-briefing

What the skills answer, with real examples → Skill descriptions and requirements →

TypeScript library

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

API reference → Library usage and architecture →

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.