Referenz

Referenz: Urlaubsanspruch

Gesetzlicher Mindesturlaub bei Teilzeit, Eintritt und Austritt im Jahr.

Berechnet den gesetzlichen Mindesturlaub nach dem Bundesurlaubsgesetz für jede Zahl von Arbeitstagen pro Woche. Mit Eintritt oder Austritt liefert der Rechner den Teilurlaub nach § 5 BUrlG samt Rundung.

Endpunkte und Aufrufe

Zugang	Aufruf
REST-API	`GET /hr/urlaubsanspruch`
SDK JavaScript	`qk.hr.urlaubsanspruch(…)`
SDK Python	`qk.hr.urlaubsanspruch(…)`
CLI	`qk urlaubsanspruch --arbeitstage-pro-woche 3`
MCP-Werkzeug	`hr_urlaubsanspruch`

Parameter

Name	Typ	Pflicht	Standard	Erlaubt	Beschreibung
`arbeitstage_pro_woche`	Zahl	ja		0.5 bis 6	Arbeitstage pro Woche, 0,5 bis 6
`jahr`	Jahr	nein	laufendes Jahr	2015 bis 2035	Kalenderjahr für die Teilurlaubsberechnung. Ohne Angabe das Jahr von Austritt oder Eintritt.
`eintritt`	Datum (JJJJ-MM-TT)	nein			Beginn des Arbeitsverhältnisses (optional)
`austritt`	Datum (JJJJ-MM-TT)	nein			Ende des Arbeitsverhältnisses (optional)

Unbekannte Parameter lehnt die API mit unbekannter_parameter ab. Dazu kommen format und trennzeichen, siehe CSV.

Antwortfelder

Feld	Typ	Bedeutung
`datensatz`	Text	Kennung des Datensatzes
`arbeitstage_pro_woche`	Dezimal	Angegebene Arbeitstage pro Woche
`anspruch_tage_jahr`	Dezimal	Gesetzlicher Jahresurlaub in Arbeitstagen
`formel`	Text	Die Rechnung in Worten
`rechtsgrundlage`	Text	Paragrafen
`hinweise`	Liste	Grenzen der Werte oder der Berechnung, in Sätzen
`quelle`	Objekt	Titel und URL der Quelle, auf der der Wert beruht
`quellen`	Liste	Alle Normen, auf denen die Antwort beruht, mit Titel und URL
`stand`	Datum	Tag der letzten Prüfung gegen die Quelle
`lizenz`	Text	Nutzungsbedingungen der Werte
`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
`anspruch_tage_im_jahr`	Dezimal	Anspruch im betrachteten Jahr, bei Teilurlaub gerundet
`teilurlaub`	Boolesch	Ob § 5 BUrlG greift
`volle_monate`	Ganzzahl	Volle Monate bei Teilurlaub

Beispiel

Aufruf mit arbeitstage_pro_woche = 3. Die Antwort erzeugt derselbe Code, der auch die API beantwortet.

api.quellenkontor.dev/v1/hr/urlaubsanspruch?arbeitstage_pro_woche=3

Zur API-Doku →

curl "https://api.quellenkontor.dev/v1/hr/urlaubsanspruch?arbeitstage_pro_woche=3" \
  -H "Authorization: Bearer $QK_KEY"

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

const qk = new Quellenkontor(process.env.QK_KEY);
const daten = await qk.hr.urlaubsanspruch({ arbeitstage_pro_woche: 3 });

import os
from quellenkontor import Quellenkontor

qk = Quellenkontor(api_key=os.environ["QK_KEY"])
daten = qk.hr.urlaubsanspruch(arbeitstage_pro_woche=3)

$ qk urlaubsanspruch --arbeitstage-pro-woche 3

{
  "name": "hr_urlaubsanspruch",
  "arguments": {
    "arbeitstage_pro_woche": 3
  }
}

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

Antwort200 OK · JSON

{
  "datensatz": "urlaubsanspruch",
  "arbeitstage_pro_woche": 3,
  "anspruch_tage_jahr": 12,
  "formel": "24 Werktage × 3 ÷ 6 = 12 Arbeitstage",
  "rechtsgrundlage": "§ 3 BUrlG",
  "hinweise": [
    "Mindesturlaub nach dem Bundesurlaubsgesetz. Vertraglicher oder tariflicher Mehrurlaub ist nicht berücksichtigt.",
    "Jugendliche haben je nach Alter zu Beginn des Kalenderjahrs 30, 27 oder 25 Werktage (§ 19 JArbSchG), schwerbehinderte Menschen bei einer Fünf-Tage-Woche fünf Arbeitstage Zusatzurlaub (§ 208 SGB IX), Pflegekräfte Mehrurlaub nach der Pflegearbeitsbedingungenverordnung (Datensatz pflegemindestlohn)."
  ],
  "quelle": {
    "titel": "§ 3 BUrlG (Dauer des Urlaubs)",
    "url": "https://www.gesetze-im-internet.de/burlg/__3.html"
  },
  "quellen": [
    {
      "titel": "§ 3 BUrlG (Dauer des Urlaubs)",
      "url": "https://www.gesetze-im-internet.de/burlg/__3.html"
    },
    {
      "titel": "§ 4 BUrlG (Wartezeit)",
      "url": "https://www.gesetze-im-internet.de/burlg/__4.html"
    },
    {
      "titel": "§ 5 BUrlG (Teilurlaub)",
      "url": "https://www.gesetze-im-internet.de/burlg/__5.html"
    }
  ],
  "stand": "2026-09-23",
  "lizenz": "Berechnung nach den genannten Normen. Nutzung nach den Nutzungsbedingungen von Quellenkontor.",
  "zitat": "Mindesturlaub nach § 3 BUrlG bei 3 Arbeitstagen pro Woche: 12 Arbeitstage im Jahr. Ohne vertraglichen Mehrurlaub; für Jugendliche und schwerbehinderte Menschen gilt mehr. Rechtsgrundlage: § 3 BUrlG. Quelle: § 3 BUrlG (Dauer des Urlaubs), https://www.gesetze-im-internet.de/burlg/__3.html. Daten: Quellenkontor (quellenkontor.dev).",
  "datenstand": "2026-09-23.1"
}

Fehlerfälle

Status	Code	Wann
400	`parameter_fehlt`	wenn arbeitstage_pro_woche fehlt
400	`ungueltiger_parameter`	falsches Format oder Wert außerhalb von: arbeitstage_pro_woche (0.5 bis 6); jahr (2015 bis 2035)
400	`unbekannter_parameter`	Parameter, den es für diesen Datensatz nicht gibt
404	`kein_wert`	außerhalb der Abdeckung (geltendes Recht) oder Wert für diesen Zeitraum noch nicht verkündet
401, 429	siehe Fehler	alle Fehlercodes

Schema für MCP

So beschreibt der MCP-Server die Argumente des Werkzeugs hr_urlaubsanspruch:

inputSchema

{
  "type": "object",
  "properties": {
    "arbeitstage_pro_woche": {
      "description": "Arbeitstage pro Woche, 0,5 bis 6",
      "type": "number",
      "minimum": 0.5,
      "maximum": 6,
      "examples": [
        5
      ]
    },
    "jahr": {
      "description": "Kalenderjahr für die Teilurlaubsberechnung. Ohne Angabe das Jahr von Austritt oder Eintritt.",
      "type": "integer",
      "minimum": 2015,
      "maximum": 2035
    },
    "eintritt": {
      "description": "Beginn des Arbeitsverhältnisses (optional)",
      "type": "string",
      "format": "date",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "austritt": {
      "description": "Ende des Arbeitsverhältnisses (optional)",
      "type": "string",
      "format": "date",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "arbeitstage_pro_woche"
  ],
  "additionalProperties": false
}

Quelle und Stand

Angabe	Inhalt
Quelle	§§ 3 bis 5 Bundesurlaubsgesetz
Lizenz	Berechnung nach den genannten Normen. Nutzung nach den Nutzungsbedingungen von Quellenkontor.
Aktualisierung	bei Gesetzesänderung
Abdeckung	Deutschland, geltendes Recht
Zuletzt geprüft	23.09.2026
Nächste erwartete Änderung	nur bei Gesetzesänderung

Überblick mit Tabellen und Fragen zum Datensatz: Urlaubsanspruch-Rechner. Einen Fehler meldest du über das Kontaktformular.

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