Urlaubsanspruch berechnen

API Der Urlaubsanspruch-Rechner läuft über die REST-API, mit Zwölftelung und Rundung nach § 5 BUrlG im JSON.

Der gesetzliche Mindesturlaub beträgt 24 Werktage bei einer Sechs-Tage-Woche (§ 3 BUrlG), bei einer Fünf-Tage-Woche also 20 Arbeitstage. Bei Teilzeit rechnest du 24 mal Arbeitstage pro Woche geteilt durch 6. Im Jahr von Eintritt oder Austritt gibt es unter Umständen nur Teilurlaub, ein Zwölftel je vollem Monat (§ 5 BUrlG).

Zuletzt gegen die Quellen geprüft am 23.09.2026. Nächste erwartete Änderung: nur bei Gesetzesänderung.

REST /v1/hr/urlaubsanspruchMCP hr_urlaubsanspruchCLI qk urlaubsanspruch

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.

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

Ein Wert passt nicht zur amtlichen Quelle? Fehler melden. Wir prüfen gegen die Primärquelle und dokumentieren jede Korrektur im Änderungsprotokoll.

Passende Lösungen: Für HR-Software Für KI-Agenten und HR-Chatbots Für internationale Payroll- und EOR-Anbieter

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."
  ],
  "quelle": {
    "titel": "§ 3 BUrlG (Dauer des Urlaubs)",
    "url": "https://www.gesetze-im-internet.de/burlg/__3.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"
}

Antwort gekürzt. Alle Parameter und Antwortfelder stehen in der Referenz zu Urlaubsanspruch.

Diesen Aufruf mit eigenem Schlüssel ausführen. 500 Abfragen im Monat kostenlos, ohne Kreditkarte.

Kostenlos starten →Referenz lesen

Gesetzlicher Mindesturlaub nach Arbeitstagen

Arbeitstage pro Woche	Mindesturlaub im Jahr
1	4 Arbeitstage
2	8 Arbeitstage
3	12 Arbeitstage
4	16 Arbeitstage
5	20 Arbeitstage
6	24 Arbeitstage

Teilurlaub bei Eintritt 2027 (Fünf-Tage-Woche)

Wer bis zum 1. Juli beginnt, erfüllt die Wartezeit von sechs Monaten im selben Jahr und bekommt den vollen Urlaub. Wer später beginnt, bekommt ein Zwölftel je vollem Monat (§ 5 Abs. 1 Buchstabe a BUrlG), Bruchteile ab einem halben Tag werden aufgerundet (§ 5 Abs. 2 BUrlG).

Eintritt am	Volle Monate im Jahr	Anspruch im Jahr
01.01.2027	Wartezeit erfüllt	20 Arbeitstage
01.02.2027	Wartezeit erfüllt	20 Arbeitstage
01.03.2027	Wartezeit erfüllt	20 Arbeitstage
01.04.2027	Wartezeit erfüllt	20 Arbeitstage
01.05.2027	Wartezeit erfüllt	20 Arbeitstage
01.06.2027	Wartezeit erfüllt	20 Arbeitstage
01.07.2027	Wartezeit erfüllt	20 Arbeitstage
01.08.2027	5	8,33 Arbeitstage
01.09.2027	4	7 Arbeitstage
01.10.2027	3	5 Arbeitstage
01.11.2027	2	3,33 Arbeitstage
01.12.2027	1	2 Arbeitstage

Parameter

Parameter	Typ	Bedeutung
`arbeitstage_pro_woche`Pflichtzahl	zahl	Arbeitstage pro Woche, 0,5 bis 6
`jahr`jahr	jahr	Kalenderjahr für die Teilurlaubsberechnung. Ohne Angabe das Jahr von Austritt oder Eintritt.
`eintritt`datum	datum	Beginn des Arbeitsverhältnisses (optional)
`austritt`datum	datum	Ende des Arbeitsverhältnisses (optional)

Alle Felder der Antwort mit Typ, erlaubte Werte, Standards und Fehlerfälle stehen in der Referenz zu Urlaubsanspruch.

Fragen zu diesem Datensatz

Wie viel Urlaub steht bei vier Arbeitstagen pro Woche zu?

16 Arbeitstage im Jahr als gesetzlicher Mindesturlaub (§ 3 BUrlG).

Wie viel Urlaub gibt es bei Eintritt am 1. August 2027?

Bei einer Fünf-Tage-Woche 8,33 Arbeitstage für 2027: ein Zwölftel des Jahresurlaubs je vollem Monat, weil die Wartezeit von sechs Monaten im Eintrittsjahr nicht mehr erfüllt wird (§ 5 Abs. 1 Buchstabe a BUrlG). Wer am 1. Juli beginnt, erfüllt sie am 31. Dezember und bekommt 20 Tage.

Gilt das auch für vertraglichen Mehrurlaub?

Nein. Der Rechner liefert den gesetzlichen Mindesturlaub. Vertraglicher oder tariflicher Mehrurlaub folgt eigenen Regeln.

Wie oft wird der Datensatz aktualisiert?

Bei Gesetzesänderung. Jede Woche prüfen wir den Bestand gegen die amtlichen Quellen, jede Änderung steht im Änderungsprotokoll. Ab dem Tarif Pro meldet ein Webhook sie deinem Server.

Mehr zu Urlaubsanspruch

Mutterschutzfristen in HR-Software automatisch eintragen Anwendungsfall
Urlaubsanspruch berechnen in Excel: Formel und Grenzen Artikel

Urlaubsanspruch berechnen

Gesetzlicher Mindesturlaub nach Arbeitstagen

Teilurlaub bei Eintritt 2027 (Fünf-Tage-Woche)

Parameter

Fragen zu diesem Datensatz

Mehr zu Urlaubsanspruch

Verwandte Datensätze

Kündigungsfristen-Rechner

Arbeitstage-Rechner

Mutterschutzfristen-Rechner

Pflegemindestlohn