ENAnmeldenKostenlos starten
Doku-Navigation: ÜberblickSo ist Quellenkontor aufgebaut
Einstieg

Dokumentation

Alles für die Einbindung: vom ersten Aufruf über die vier Zugänge bis zu Webhooks, Fehlercodes und der Referenz jedes Datensatzes.

Auf einen Blick
Basis-URL
https://api.quellenkontor.dev/v1
Schlüssel
Authorization: Bearer $QK_KEY
MCP-Server
https://mcp.quellenkontor.dev/v1
OpenAPI
https://api.quellenkontor.dev/v1/openapi.json
SDK
npm install @quellenkontor/sdk pip install quellenkontor
CLI
npm install -g @quellenkontor/cli

So ist Quellenkontor aufgebaut

#

Quellenkontor liefert geprüfte Werte aus dem deutschen Arbeits- und Sozialversicherungsrecht. Jeder Wert kommt mit Rechtsgrundlage, amtlicher Quelle und dem Tag, ab dem er gilt. Es gibt zwei Arten von Datensätzen:

  • Tabellen enthalten amtliche Werte mit Gültigkeitszeitraum, zum Beispiel Mindestlohn, Beitragsbemessungsgrenzen oder Sachbezugswerte. Du fragst sie für einen Stichtag ab und bekommst den Wert, der an diesem Tag gilt.
  • Rechner wenden eine gesetzliche Regel auf deine Eingaben an, zum Beispiel die Kündigungsfrist nach § 622 BGB oder die Arbeitstage zwischen zwei Daten in einem Bundesland.

Beide erreichst du mit demselben Schlüssel über vier Zugänge. Die Antworten haben überall dieselben Felder, egal ob sie aus der REST-API, dem SDK, der Kommandozeile oder dem MCP-Server kommen.

Die vier Zugänge

#
ZugangGut fürDoku
REST-APIjede Programmiersprache, direkte HTTP-Aufrufe, eigene Clients aus der OpenAPI-BeschreibungREST-API
SDKJavaScript, TypeScript und Python, mit Typen, Zeitlimit und automatischen WiederholungenJavaScript, Python
CLITerminal, Shell-Skripte, Cronjobs und CSV-ExportCLI
MCP-ServerKI-Agenten in Claude Code, Cursor, VS Code und anderen ClientsMCP-Server

Erste Schritte

#
  1. Kostenlos anmelden. Neue Konten haben 500 Abfragen im Monat, ohne Kreditkarte.
  2. Im Konto einen Schlüssel erzeugen und als Umgebungsvariable QK_KEY ablegen.
  3. Dem Schnellstart folgen: die erste Abfrage mit curl, SDK, CLI oder MCP.
  4. Die Seite Stichtage und Gültigkeit lesen und in der Referenz den Datensatz nachschlagen, den du brauchst.

Alle Seiten der Doku

#

Einstieg

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

Grundlagen

AuthentifizierungEin Schlüssel gilt für alle vier Zugänge. Hier steht, wie du ihn mitschickst, sicher aufbewahrst und ohne Ausfall austauschst.Stichtage und GültigkeitJeder Wert gilt ab einem bestimmten Tag. So fragst du Werte für jeden Stichtag ab, erkennst künftige Änderungen und gehst mit Lücken um.Antworten und CSVWie Antworten aufgebaut sind, wie Zahlen und Daten codiert sind und wie du Listen als CSV in Excel oder deine Datenbank bekommst.

Zugänge

REST-APIDie HTTP-Schnittstelle für jede Programmiersprache. Alle Datensätze antworten auf GET mit JSON, Listen auf Wunsch als CSV.SDK JavaScriptDas offizielle Paket für Node.js ab Version 18. Ohne Abhängigkeiten und mit Typen für jede Antwort.SDK PythonDas offizielle Paket ab Python 3.9, nur mit der Standardbibliothek. Jede Methode liefert ein dict mit denselben Feldern wie die API.CLIMit qk fragst du jeden Datensatz im Terminal ab, exportierst Listen als CSV und baust Werte in Skripte und Cronjobs ein.MCP-ServerEin entfernter MCP-Server mit einem Werkzeug je Datensatz. Agenten schlagen Werte nach, statt sie zu schätzen, und zitieren die Quelle.

Referenz

Alle DatensätzeFür jeden Datensatz eine eigene Seite mit Endpunkten, Parametern, allen Antwortfeldern, echten Beispielen und Fehlerfällen.

Einzelne Datensätze: Mindestlohn, Ausbildungsvergütung, Pflegemindestlohn, Beitragsbemessungsgrenzen, Beitragssätze, Sachbezugswerte, Pfändungsfreigrenzen, Übergangsbereich, Minijob-Abgaben, Künstlersozialabgabe, Ausgleichsabgabe, Freibeträge und Pauschalen, Reisekosten, SFN-Zuschläge, Dienstwagen, Grundfreibetrag, Kündigungsfrist, Urlaubsanspruch, Mutterschutz, Feiertage, Arbeitstage, Regelaltersgrenze, Pausenregelung.

Betrieb

WebhooksAb dem Tarif Pro meldet Quellenkontor jeden neuen oder geänderten Wert an deinen Server. So pflegst du Werte, ohne selbst nachzusehen.FehlerJeder Fehler kommt mit einem festen Code, einer Erklärung auf Deutsch und, wo es passt, dem betroffenen Parameter.Kontingente und LimitsJeder Tarif hat ein Monatskontingent. Gezählt werden nur Abfragen, die ein Ergebnis liefern.ÄnderungsprotokollJede Änderung am Bestand, mit Datum und Beleg. Dieselben Einträge lösen die Webhooks aus.

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