Stichtage, Gültigkeit und künftige Werte

Tabellen-Datensätze fragst du für einen Stichtag ab. Die Antwort enthält den Wert, der an diesem Tag gilt. Ohne Angabe gilt der heutige Tag in Deutschland. Datensätze, deren Werte immer für ein ganzes Kalenderjahr gelten, nehmen statt eines Datums ein Jahr.

Ein Beispiel: Am 31.12.2026 beträgt der Mindestlohn 13,9 Euro je Stunde, am 01.01.2027 sind es 14,6 Euro. Zwei Abfragen, ein Tag Abstand:

curl "https://api.quellenkontor.dev/v1/hr/mindestlohn?datum=2026-12-31" \
  -H "Authorization: Bearer $QK_KEY"

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

Rechner nehmen eigene Daten entgegen, etwa Eintritt und Zugang der Kündigung. Welche das sind, steht in der Referenz des jeweiligen Datensatzes.

Jede Antwort eines Tabellen-Datensatzes sagt, seit wann und bis wann der Wert gilt und worauf er beruht:

Mit naechster_wert erkennst du eine beschlossene Änderung schon heute und kannst sie in deiner Software vorbereiten.

Künftige Werte tragen wir ein, sobald sie amtlich verkündet sind, also im Bundesgesetzblatt oder im Bundesanzeiger stehen. Referentenentwürfe und Kabinettsbeschlüsse übernehmen wir nicht. Bis zur Verkündung sagt die API ausdrücklich, dass ein Wert fehlt. Sie rät nie.

Wert noch nicht festgelegt

Für Jahre ohne verkündeten Wert antwortet die API mit Status 404 und dem Code kein_wert. Aktuell liegen die Rechengrößen bis 2026 vor. Eine Abfrage für 2027 ergibt:

{
  "fehler": {
    "code": "kein_wert",
    "nachricht": "Die Rechengrößen für 2027 sind noch nicht amtlich festgelegt. Verfügbar bis 2026.",
    "parameter": "jahr"
  }
}

Teilweise festgelegt

Bei den Beitragssätzen sind alle Bestandteile bis 31.12.2026 verkündet. Für spätere Stichtage liefert die API die zuletzt beschlossenen Sätze und setzt vorlaeufig auf true. Abfrage für den 01.06.2027:

{
  "vorlaeufig": true,
  "hinweise": [
    "Für Stichtage nach dem 31.12.2026 sind noch nicht alle Sätze festgelegt. Angezeigt sind die zuletzt beschlossenen Werte. Fehlende Bestandteile, etwa der durchschnittliche Zusatzbeitrag, folgen nach ihrer Bekanntmachung."
  ]
}

Angekündigt, aber noch ohne Wert

Manchmal steht schon fest, dass sich ein Wert ändert, aber nicht, wie hoch er wird. Beispiel: Ab 01.01.2027 richtet sich der Pauschalbeitrag zur Krankenversicherung im gewerblichen Minijob nach dem durchschnittlichen Zusatzbeitrag, der erst im Herbst bekannt gemacht wird. Dann steht der Bestandteil mit wert: null, status: "ausstehend" und der Rechtsgrundlage der Neuregelung in der Antwort, statt still zu fehlen:

{
  "id": "gewerblich_kv",
  "name": "Pauschalbeitrag Krankenversicherung, gewerblicher Minijob",
  "gruppe": "Gewerblich",
  "einheit": "prozent",
  "wert": null,
  "gueltig_ab": "2027-01-01",
  "gueltig_bis": null,
  "rechtsgrundlage": "§ 249b Satz 1 SGB V in der Fassung von Artikel 1 Nr. 64 des GKV-Beitragssatzstabilisierungsgesetzes, in Kraft ab 01.01.2027",
  "quelle": {
    "titel": "Gesetz zur Stabilisierung der Beitragssätze in der gesetzlichen Krankenversicherung vom 24. Juli 2026 (BGBl. 2026 I Nr. 228)",
    "url": "https://www.recht.bund.de/bgbl/1/2026/228/VO.html"
  },
  "hinweis": "Nur für gesetzlich krankenversicherte Minijobber. Ab 01.01.2027 gilt der allgemeine Beitragssatz zuzüglich des durchschnittlichen Zusatzbeitragssatzes (§ 249b Satz 1 SGB V in der ab 2027 geltenden Fassung). Den Wert tragen wir im wöchentlichen Prüflauf ein, nachdem der durchschnittliche Zusatzbeitragssatz für 2027 bekannt gemacht ist.",
  "naechster_wert": null,
  "status": "ausstehend",
  "erwartet": "allgemeiner Beitragssatz plus durchschnittlicher Zusatzbeitragssatz 2027, dessen Bekanntmachung bis 01.11.2026 erwartet wird"
}

Jährlich festgesetzte Werte

Einige Werte gelten nur für ein Kalenderjahr, etwa der Abgabesatz der Künstlersozialabgabe. Für Jahre nach der letzten Verordnung antwortet die API mit kein_wert, auch wenn der alte Satz vermutlich weiter gilt.

Vor 2015

Die Tabellen reichen bis zum 01.01.2015 zurück, die Mindestausbildungsvergütung bis zum Ausbildungsbeginn 01.01.2020. Frühere Stichtage ergeben ebenfalls kein_wert.

Für jede Tabelle gibt es einen Verlauf mit allen Stufen seit 2015. Eine Abfrage des Verlaufs zählt wie eine normale Abfrage. Er eignet sich, um die Werte einmal vollständig in die eigene Datenbank zu übernehmen. Jede Zeile hat ein Ende in gueltig_bis, nur die geltende Stufe hat null.

curl "https://api.quellenkontor.dev/v1/hr/mindestlohn/verlauf" \
  -H "Authorization: Bearer $QK_KEY"

Mit von und bis kommen nur die Stufen, die in diesem Zeitraum gelten, bei Datensätzen aus Bestandteilen mit bestandteil nur ein Posten:

curl "https://api.quellenkontor.dev/v1/hr/pflegemindestlohn/verlauf?bestandteil=pflegefachkraft&von=2025-01-01" \
  -H "Authorization: Bearer $QK_KEY"

Mit format=csv kommt derselbe Verlauf als CSV-Datei, siehe Antworten und CSV.

Alle Daten sind Kalendertage ohne Uhrzeit im Format JJJJ-MM-TT. "Heute" bedeutet der aktuelle Tag in Deutschland (Europe/Berlin). Ein neuer Wert gilt ab 00:00 Uhr deutscher Zeit an seinem Gültigkeitstag. Wenn dein Server in einer anderen Zeitzone läuft, gib das Datum ausdrücklich mit, statt dich auf "heute" zu verlassen.

Die Rechner wenden die gesetzliche Regel schematisch an: Kündigungsfristen nach § 622 BGB, Urlaub nach dem Bundesurlaubsgesetz, Mutterschutzfristen nach § 3 MuSchG, Feiertage nach den Feiertagsgesetzen der Länder. Sie kennen keine Arbeits- oder Tarifverträge und keine Besonderheiten des Einzelfalls. Wo eine Berechnung eine Annahme trifft, steht das im Feld hinweise.

Die Referenz jedes Rechners beschreibt, welche Regel er anwendet und welche Fälle er nicht abdeckt.

Die meisten Werte ändern sich ein- oder zweimal im Jahr, meist zum 1. Januar oder 1. Juli. Du darfst Antworten zwischenspeichern und sparst damit Abfragen. Bewährt haben sich zwei Wege:

• Tages-Cache: Antworten je Stichtag und Parameter einen Tag lang speichern. Einfach und für die meisten Anwendungen genau genug.
• Eigene Tabelle: Den Verlauf einmal übernehmen und neue Stufen per Webhook nachziehen. So fragt deine Software nur noch, wenn sich wirklich etwas ändert.

Die API setzt Cache-Control: no-store, damit Zwischenspeicher im Netz keine Antworten mit deinem Schlüssel aufbewahren. Das Zwischenspeichern in deiner eigenen Anwendung betrifft das nicht.