Quellenkontor

Amtliche HR-Werte für Deutschland per API, SDK, CLI und MCP. Jeder Wert mit Quelle, Rechtsgrundlage und Gültigkeit.

Mindestlohn, Beitragsbemessungsgrenzen, Beitragssätze, Sachbezugswerte, Feiertage je Bundesland, Kündigungsfristen und 17 weitere Datensätze. Du fragst mit einem Stichtag ab und bekommst den Wert, der an diesem Tag gilt, samt Fundstelle im Bundesgesetzblatt oder Bundesanzeiger.

Website · Dokumentation · Kostenloser Schlüssel · Guides · English

Warum es das gibt

Jede HR- und Lohnsoftware in Deutschland pflegt dieselben Werte: zum 1. Januar, zum 1. Juli und immer dann, wenn eine Verordnung erscheint. Meist hängt das an einer Person, einer Tabelle und einem Kalendereintrag. Wird ein Wert zu spät oder falsch eingetragen, rechnet die Abrechnung falsch, und niemand merkt es sofort.

Quellenkontor übernimmt diese Pflege. Jeder Wert wird aus der amtlichen Quelle übernommen, geprüft und mit Gültigkeitszeitraum gespeichert. Künftige Werte kommen erst hinein, wenn sie verkündet sind, nicht schon beim Referentenentwurf. Wie das im Einzelnen läuft, steht im Prüfverfahren.

So sieht eine Antwort aus

Terminal

curl "https://api.quellenkontor.dev/v1/hr/mindestlohn?datum=2027-01-15"

config.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"
  },
  "vorheriger_wert": {
    "gueltig_ab": "2026-01-01",
    "mindestlohn_brutto_stunde": 13.9,
    "minijob_grenze_monat": 603
  }
}

Diese Abfrage funktioniert ohne Schlüssel. Mindestlohn, Feiertage und Rechengrößen antworten in einer Sandbox mit 50 Abfragen am Tag. Die Antwort ist hier gekürzt, die volle Fassung enthält noch Hinweise, Lizenz und einen fertigen Zitiersatz.

Für wen

Du baust	Das nimmt dir Quellenkontor ab
Lohn- und Gehaltssoftware	Rechengrößen, Beitragssätze, Sachbezugswerte und Übergangsbereich zu jedem Stichtag, auch rückwirkend. Mehr
HR-Software	Feiertage je Bundesland, Arbeitstage, Kündigungsfristen, Urlaubsanspruch und Mutterschutz als fertige Rechner. Mehr
HR-Chatbots und KI-Agenten	Ein MCP-Server, über den der Agent Werte nachschlägt, statt sie aus dem Gedächtnis zu nennen. Mehr
Payroll und Employer of Record	Deutsche Lohnwerte aus einer Quelle, statt ein Dutzend Behördenseiten zu verfolgen. Mehr

Guides

Kurze Anleitungen für typische Aufgaben, jeweils mit Code zum Kopieren.

Weitere Anwendungsfälle mit Hintergrund stehen auf quellenkontor.dev/anwendungsfaelle.

Die Datensätze

Bereich	Datensätze
Lohn	Mindestlohn und Minijob-Grenze, Mindestausbildungsvergütung, Pflegemindestlohn
Sozialversicherung	Rechengrößen, Beitragssätze, Übergangsbereich (Midijob), Minijob-Abgaben, Künstlersozialabgabe, Ausgleichsabgabe
Steuer	Sachbezugswerte, steuerfreie Beträge, Reisekosten im Inland, SFN-Zuschläge, Dienstwagen, Einkommensteuer-Eckwerte
Arbeitsrecht und Fristen	Kündigungsfrist, Urlaubsanspruch, Mutterschutz, Pausenregelung, Regelaltersgrenze, Pfändungsfreigrenzen
Kalender	Feiertage je Bundesland, Arbeitstage

Parameter und Felder jedes Datensatzes stehen in der Referenz. Die Liste als JSON liefert https://api.quellenkontor.dev/v1/datensaetze.

Loslegen

Dieses Repository enthält die offiziellen Clients. Sie kommen ohne Pflicht-Abhängigkeiten aus (nur der asynchrone Python-Client braucht httpx, pip install "quellenkontor[async]") und sprechen dieselbe API.

Paket	Installation	Doku
JavaScript/TypeScript SDK	`npm install @quellenkontor/sdk`	SDK für JavaScript
Python SDK	`pip install quellenkontor`	SDK für Python
CLI	`npm install -g @quellenkontor/cli`	Kommandozeile
MCP-Server	`https://mcp.quellenkontor.dev/v1` (Einrichtung im Guide)	MCP

server.ts

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

const qk = new Quellenkontor(process.env.QK_KEY);

const frist = await qk.hr.kuendigungsfrist({ eintritt: "2017-03-01", zugang: "2026-11-10" });
console.log(frist.ende); // "2027-02-28"

server.ts

import os
from quellenkontor import Quellenkontor

qk = Quellenkontor(api_key=os.environ["QK_KEY"])

ml = qk.hr.mindestlohn(datum="2027-01-15")
print(ml["mindestlohn_brutto_stunde"])  # 14.6

Terminal

npx @quellenkontor/cli feiertage --jahr 2027 --land HE --format csv > feiertage.csv

Ein kostenloser Schlüssel mit 500 Abfragen im Monat liegt unter quellenkontor.dev/anmelden bereit. Kein Passwort, keine Kreditkarte. Die Schritte bis zur ersten Abfrage stehen im Schnellstart.

Kontakt

Fehler und Wünsche gern als Issue oder an hello@quellenkontor.dev.

Die Clients in diesem Repository stehen unter MIT-Lizenz. Die Daten liefert die API, die Bedingungen dafür stehen in den Nutzungsbedingungen.

English

Official German HR reference data via API, SDK, CLI and MCP. Every value comes with its official source, legal basis and effective date.

Minimum wage, social security ceilings and rates, benefits in kind, public holidays by state, notice periods and 17 more datasets. Query with a reference date and get the value that applies on that day, including the citation in the Federal Law Gazette or Federal Gazette. Field and parameter names are German, as in the API.

Docs: quellenkontor.dev/en/docs
Free key (500 requests a month): quellenkontor.dev/en/sign-in
Packages: npm install @quellenkontor/sdk, pip install quellenkontor, npm install -g @quellenkontor/cli