Zugänge

Kommandozeile (CLI)

Mit qk fragst du jeden Datensatz im Terminal ab, exportierst Listen als CSV und baust Werte in Skripte und Cronjobs ein.

Installation

Die Kommandozeile heißt qk und braucht Node.js ab Version 18. Du installierst sie global oder rufst sie einmalig über npx auf:

Terminal

npm install -g @quellenkontor/cli

# ohne Installation
npx @quellenkontor/cli mindestlohn --datum 2027-01-15

Schlüssel hinterlegen

qk login fragt nach deinem Schlüssel und speichert ihn in ~/.config/quellenkontor/config.json, lesbar nur für deinen Benutzer. Ist XDG_CONFIG_HOME gesetzt, liegt die Datei dort. qk logout löscht sie wieder. Der Schlüssel selbst bleibt gültig, bis du ihn im Konto sperrst.

Ist die Umgebungsvariable QK_KEY gesetzt, hat sie Vorrang vor der gespeicherten Datei. Auf Servern und in CI-Läufen ist das der bessere Weg.

Terminal

$ qk login
API-Schlüssel (beginnt mit qk_live_): qk_live_…
Gespeichert in /Users/du/.config/quellenkontor/config.json.

Aufbau eines Befehls

Schema

qk <datensatz> [--parameter wert …] [--format tabelle|json|csv]
qk <datensatz> verlauf [--format tabelle|json|csv]

Jeder Datensatz ist ein Befehl, jeder Parameter eine Option. Aus Unterstrichen werden Bindestriche: arbeitstage_pro_woche heißt --arbeitstage-pro-woche.
Werte stehen nach einem Leerzeichen oder einem Gleichheitszeichen: --jahr 2027 oder --jahr=2027.
Eine Option ohne Wert gilt als true: --probezeit entspricht --probezeit true.

Alle Befehle

Befehl	Beispiel	Verlauf
qk mindestlohn	`qk mindestlohn --datum 2027-01-15`	`qk mindestlohn verlauf`
qk mindestausbildungsverguetung	`qk mindestausbildungsverguetung --beginn 2026-08-01 --ausbildungsjahr 2`	`qk mindestausbildungsverguetung verlauf`
qk pflegemindestlohn	`qk pflegemindestlohn --datum 2027-07-01`	`qk pflegemindestlohn verlauf`
qk rechengroessen	`qk rechengroessen --jahr 2026`	`qk rechengroessen verlauf`
qk beitragssaetze	`qk beitragssaetze --datum 2026-07-01`	`qk beitragssaetze verlauf`
qk sachbezugswerte	`qk sachbezugswerte --jahr 2026`	`qk sachbezugswerte verlauf`
qk pfaendungsfreigrenzen	`qk pfaendungsfreigrenzen --datum 2026-07-01 --unterhaltspflichten 1 --netto 2500`	`qk pfaendungsfreigrenzen verlauf`
qk uebergangsbereich	`qk uebergangsbereich --datum 2026-01-01`	`qk uebergangsbereich verlauf`
qk minijob-abgaben	`qk minijob-abgaben --datum 2026-10-01`	`qk minijob-abgaben verlauf`
qk kuenstlersozialabgabe	`qk kuenstlersozialabgabe --jahr 2027`	`qk kuenstlersozialabgabe verlauf`
qk ausgleichsabgabe	`qk ausgleichsabgabe --jahr 2025 --arbeitsplaetze 120 --besetzt 2`	`qk ausgleichsabgabe verlauf`
qk steuerfreie-betraege	`qk steuerfreie-betraege --datum 2026-10-01`	`qk steuerfreie-betraege verlauf`
qk reisekosten-inland	`qk reisekosten-inland --datum 2026-10-01`	`qk reisekosten-inland verlauf`
qk sfn-zuschlaege	`qk sfn-zuschlaege --datum 2026-12-24 --grundlohn-stunde 22.5`	`qk sfn-zuschlaege verlauf`
qk dienstwagen	`qk dienstwagen --listenpreis 58900 --antrieb elektro --anschaffung 2025-09-01 --entfernung-km 18`	nein
qk einkommensteuer-eckwerte	`qk einkommensteuer-eckwerte --jahr 2026`	`qk einkommensteuer-eckwerte verlauf`
qk kuendigungsfrist	`qk kuendigungsfrist --eintritt 2017-03-01 --zugang 2026-11-10`	nein
qk urlaubsanspruch	`qk urlaubsanspruch --arbeitstage-pro-woche 3`	nein
qk mutterschutz	`qk mutterschutz --termin 2027-03-15`	nein
qk feiertage	`qk feiertage --jahr 2027 --land HE`	nein
qk arbeitstage	`qk arbeitstage --von 2027-01-01 --bis 2027-01-31 --land HE`	nein
qk regelaltersgrenze	`qk regelaltersgrenze --geburtsdatum 1961-08-15`	nein
qk pausen	`qk pausen --arbeitszeit-stunden 9.5`	nein
qk datensaetze	alle Datensätze mit ihren Optionen

Ausgabe als Tabelle, JSON und CSV

Ohne weitere Angabe zeigt qk eine Tabelle. Verschachtelte Felder erscheinen als feld.unterfeld, Listen wie Feiertage als eigene Tabelle darunter. Steht in einer Zelle null, gibt es für den Stichtag keinen Wert, genau wie in der JSON-Antwort.

Terminal

$ qk mindestlohn --datum 2027-01-15
datensatz                                  mindestlohn
datum                                      2027-01-15
mindestlohn_brutto_stunde                  14.6
minijob_grenze_monat                       633
gueltig_ab                                 2027-01-01
gueltig_bis                                null
rechtsgrundlage                            Fünfte Mindestlohnanpassungsverordnung vom 5. November 2025 (BGBl. 2025 I Nr. 268), Stufe 2
quelle.titel                               Fünfte Mindestlohnanpassungsverordnung vom 5. November 2025 (BGBl. 2025 I Nr. 268)
quelle.url                                 https://www.recht.bund.de/bgbl/1/2025/268/VO.html
minijob_rechtsgrundlage                    § 8 Abs. 1a SGB IV (Mindestlohn × 130 ÷ 3, aufgerundet auf volle Euro)
minijob_quelle.titel                       Bekanntmachung der Geringfügigkeitsgrenze nach § 8 Absatz 1a SGB IV vom 7. November 2025 (BAnz AT 20.11.2025 B1)
minijob_quelle.url                         https://www.bundesanzeiger.de/pub/publication/VaPRG6wPGXte9CM3jI4/content/VaPRG6wPGXte9CM3jI4/BAnz%20AT%2020.11.2025%20B1.pdf
vorheriger_wert.gueltig_ab                 2026-01-01
vorheriger_wert.mindestlohn_brutto_stunde  13.9
vorheriger_wert.minijob_grenze_monat       603
naechster_wert                             null
hinweise                                   Die Minijob-Grenze gilt je Monat. Gelegentliches unvorhersehbares Überschreiten ist in engen Grenzen erlaubt (§ 8 Abs. 1b SGB IV). | Die Pauschalabgaben des Arbeitgebers für Minijobs (Kranken- und Rentenversicherung, Pauschsteuer, Umlagen) liefert der Datensatz minijob-abgaben (/v1/hr/minijob-abgaben).
lizenz                                     Werte aus amtlichen Werken (§ 5 UrhG). Nutzung der Zusammenstellung nach den Nutzungsbedingungen von Quellenkontor.
stand                                      2026-09-23
zitat                                      Gesetzlicher Mindestlohn in Deutschland am 15.01.2027: 14,60 Euro brutto je Stunde, gültig ab 01.01.2027. Minijob-Grenze: 633 Euro im Monat. Rechtsgrundlage: Fünfte Mindestlohnanpassungsverordnung vom 5. November 2025, Stufe 2. Quelle: Fünfte Mindestlohnanpassungsverordnung vom 5. November 2025 (BGBl. 2025 I Nr. 268), https://www.recht.bund.de/bgbl/1/2025/268/VO.html. Daten: Quellenkontor (quellenkontor.dev).
datenstand                                 2026-09-23.1

Mit --format json kommt die Antwort unverändert als JSON, mit --format csv als CSV für Listen. Für ein deutsches Excel hängst du --trennzeichen semikolon an. Dann setzt qk auch ein BOM an den Anfang der Datei, damit Excel die Umlaute richtig liest.

Terminal

qk feiertage --jahr 2027 --land HE --format csv --trennzeichen semikolon > feiertage.csv

In Skripten und Cronjobs

Fehler landen auf stderr als eine Zeile mit Status und Code, zum Beispiel Fehler 400 (ungueltiger_parameter): Der Parameter datum muss ein Datum im Format JJJJ-MM-TT sein, zum Beispiel 2027-01-15.. Der Rückgabewert ist dann 1, bei Erfolg 0. So brichst du ein Skript sauber ab.

Mit jq weiterverarbeiten

Terminal

qk feiertage --jahr 2027 --land BY --format json | jq -r '.feiertage[] | "\(.datum) \(.name)"'

Monatlicher Export per Cron

crontab

# am 1. jedes Monats um 6 Uhr den Verlauf der Rechengrößen sichern
0 6 1 * * QK_KEY=qk_live_… qk rechengroessen verlauf --format csv > /daten/rechengroessen.csv

Im Cronjob steht der Schlüssel besser in einer Datei mit eingeschränkten Rechten, die das Skript einliest, als direkt in der crontab.

Hilfe und Version

Terminal

qk hilfe
qk version
qk datensaetze

Alle Optionen je Datensatz mit Typ, Standard und erlaubten Werten stehen in der Referenz.

Fehlt etwas oder ist etwas unklar? Schreib uns, wir ergänzen die Doku.