Einstieg

Schnellstart: in fünf Minuten zur ersten Antwort

Von der Anmeldung bis zur ersten echten Antwort in vier Schritten. Du brauchst nur eine E-Mail-Adresse und ein Terminal.

1. Konto anlegen

Auf der Seite Anmelden trägst du deine E-Mail-Adresse ein und bestätigst, dass du Quellenkontor für ein Unternehmen, eine Selbstständigkeit oder eine Behörde nutzt. Du bekommst einen Link, der 20 Minuten gilt und einmal funktioniert. Ein Klick darauf, und du bist angemeldet. Ein Passwort gibt es nicht.

Neue Konten starten im Tarif Kostenlos mit 500 Abfragen im Monat. Eine Kreditkarte brauchst du dafür nicht.

Ganz ohne Konto testen geht auch: Mindestlohn, Feiertage und Rechengrößen antworten in einer Sandbox ohne Schlüssel, begrenzt auf 50 Abfragen am Tag, siehe Sandbox ohne Konto.

2. Schlüssel erzeugen

Im Konto gibst du dem Schlüssel einen Namen, zum Beispiel "Entwicklung", und klickst auf "Schlüssel erzeugen". Der Schlüssel beginnt mit qk_live_ und wird genau einmal angezeigt. Kopiere ihn sofort, danach siehst du im Konto nur noch den Anfang.

Leg den Schlüssel als Umgebungsvariable QK_KEY ab. SDK und CLI lesen sie automatisch, in curl setzt du sie in den Header.

macOS und Linux

Terminal

export QK_KEY="qk_live_DEIN_SCHLUESSEL"

Windows (PowerShell)

PowerShell

$env:QK_KEY = "qk_live_DEIN_SCHLUESSEL"

In einem Projekt

Trag den Schlüssel in eine Datei .env ein und nimm die Datei in .gitignore auf:

.env

QK_KEY=qk_live_DEIN_SCHLUESSEL

Ein Schlüssel gehört nicht in ein Repository, nicht in Frontend-Code und nicht in eine E-Mail. Ist einer in falsche Hände geraten, sperrst du ihn im Konto mit einem Klick. Mehr dazu unter Authentifizierung.

3. Erste Abfrage senden

Frag den Mindestlohn am 15. Januar 2027 ab. Das Datum steht im Format JJJJ-MM-TT:

Terminal

curl "https://api.quellenkontor.dev/v1/hr/mindestlohn?datum=2027-01-15" \
  -H "Authorization: Bearer $QK_KEY"

Die Antwort kommt als JSON, hier die echte Antwort für diesen Aufruf:

Antwort

{
  "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)",
    "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)",
    "url": "https://www.bundesanzeiger.de/pub/publication/VaPRG6wPGXte9CM3jI4/content/VaPRG6wPGXte9CM3jI4/BAnz%20AT%2020.11.2025%20B1.pdf"
  },
  "vorheriger_wert": {
    "gueltig_ab": "2026-01-01",
    "mindestlohn_brutto_stunde": 13.9,
    "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"
}

4. Antwort lesen

Jede Antwort nennt den Datensatz, den abgefragten Stichtag, den Wert, seine Gültigkeit und die amtliche Quelle. Die Felder dieses Datensatzes:

Feld	Typ	Bedeutung
`datensatz`	Text	Kennung des Datensatzes
`datum`	Datum	Abgefragter Stichtag
`mindestlohn_brutto_stunde`	Dezimal	Euro je Stunde
`minijob_grenze_monat`	Ganzzahl	Euro je Monat
`gueltig_ab`	Datum	Beginn der Gültigkeit des Werts
`gueltig_bis`	Datum oder null	Ende der Gültigkeit, null solange kein Nachfolger feststeht
`rechtsgrundlage`	Text	Gesetz oder Verordnung
`quelle`	Objekt	Titel und URL der Primärquelle
`minijob_rechtsgrundlage`	Text	Rechtsgrundlage der Minijob-Grenze
`minijob_quelle`	Objekt	Quelle der Minijob-Grenze
`vorheriger_wert`	Objekt oder null	Die Stufe davor
`naechster_wert`	Objekt oder null	Die nächste beschlossene Stufe
`hinweise`	Liste	Grenzen der Werte oder der Berechnung, in Sätzen
`lizenz`	Text	Nutzungsbedingungen der Werte
`stand`	Datum	Tag der letzten Prüfung gegen die Quelle
`zitat`	Text	Fertiger Satz mit Wert, Gültigkeit, Rechtsgrundlage und Quelle zum Zitieren
`datenstand`	Text	Kennung des Datenstands: Datum und laufende Nummer der letzten Änderung im Änderungsprotokoll (/v1/aenderungen), die diesen Datensatz betrifft. Gleicher Datenstand heißt unveränderter Inhalt, praktisch für Prüfer und zum Vergleich zweier Abfragen

Jede Antwort mit Schlüssel trägt außerdem zwei Header zum Verbrauch: X-Kontingent-Limit und X-Kontingent-Verbraucht. Mit curl -i siehst du sie über dem JSON.

Derselbe Aufruf auf allen Wegen

Die vier Reiter zeigen denselben Aufruf über REST-API, SDK, Kommandozeile und MCP. Die Antwort ist in allen Fällen dieselbe.

api.quellenkontor.dev/v1/hr/mindestlohn?datum=2027-01-15

Zur API-Doku →

curl "https://api.quellenkontor.dev/v1/hr/mindestlohn?datum=2027-01-15" \
  -H "Authorization: Bearer $QK_KEY"

import { Quellenkontor } from "@quellenkontor/sdk";

const qk = new Quellenkontor(process.env.QK_KEY);
const daten = await qk.hr.mindestlohn({ datum: "2027-01-15" });

import os
from quellenkontor import Quellenkontor

qk = Quellenkontor(api_key=os.environ["QK_KEY"])
daten = qk.hr.mindestlohn(datum="2027-01-15")

$ qk mindestlohn --datum 2027-01-15

{
  "name": "hr_mindestlohn",
  "arguments": {
    "datum": "2027-01-15"
  }
}

So ruft ein Agent das Werkzeug auf. Die Einrichtung des Servers steht in der MCP-Doku.

Antwort200 OK · JSON

{
  "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)",
    "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)",
    "url": "https://www.bundesanzeiger.de/pub/publication/VaPRG6wPGXte9CM3jI4/content/VaPRG6wPGXte9CM3jI4/BAnz%20AT%2020.11.2025%20B1.pdf"
  },
  "vorheriger_wert": {
    "gueltig_ab": "2026-01-01",
    "mindestlohn_brutto_stunde": 13.9,
    "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"
}

Wenn es nicht klappt

Du siehst	Ursache	Lösung
`schluessel_fehlt`	Der Header Authorization fehlt, oder die Umgebungsvariable ist in diesem Terminal nicht gesetzt.	Mit echo $QK_KEY prüfen, ob die Variable einen Wert hat, und den Aufruf im selben Fenster wiederholen.
`schluessel_ungueltig`	Der Schlüssel ist unvollständig kopiert oder gesperrt.	Im Konto prüfen, ob der Schlüssel aktiv ist. Sonst einen neuen erzeugen.
`ungueltiger_parameter`	Ein Wert hat das falsche Format, etwa 15.01.2027 statt 2027-01-15.	Die Meldung nennt den Parameter und das erwartete Format.
`unbekannter_parameter`	Tippfehler im Namen eines Parameters.	Die Meldung zählt die erlaubten Namen auf.
`kein_wert`	Für den Stichtag gibt es keinen amtlichen Wert, etwa vor 2015 oder für ein Jahr, das noch nicht festgelegt ist.	Stichtag prüfen, siehe Stichtage und Gültigkeit.
`kontingent_erreicht`	Das Kontingent des Monats ist aufgebraucht.	Bis zum Monatsersten warten oder im Konto den Tarif wechseln.

Alle Codes mit Status und Lösung stehen unter Fehler und Fehlercodes.

Nächste Schritte

Stichtage und Gültigkeit: wie Werte zeitlich gelten und was bei künftigen Werten passiert.
Referenz: Parameter und Felder jedes Datensatzes.
SDK für JavaScript oder SDK für Python, wenn du lieber mit Methoden als mit URLs arbeitest.
MCP-Server, wenn ein KI-Agent die Werte nachschlagen soll.
Webhooks, wenn deine Software neue Werte automatisch übernehmen soll.

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