Referenz

Referenz: Feiertage

Feiertage je Bundesland und Jahr, regionale Feiertage gekennzeichnet.

Die gesetzlichen Feiertage der 16 Länder nach heutigem Stand der Feiertagsgesetze, berechnet für 2015 bis 2035, mit Wochentag, regionalen Feiertagen wie Fronleichnam in Teilen Sachsens und einmaligen Feiertagen. Feiertage, die immer auf einen Sonntag fallen, sind für Zuschläge eigens gekennzeichnet.

Endpunkte und Aufrufe

Zugang	Aufruf
REST-API	`GET /hr/feiertage`
SDK JavaScript	`qk.hr.feiertage(…)`
SDK Python	`qk.hr.feiertage(…)`
CLI	`qk feiertage --jahr 2027 --land HE`
MCP-Werkzeug	`hr_feiertage`

Parameter

Name	Typ	Pflicht	Standard	Erlaubt	Beschreibung
`jahr`	Jahr	nein	laufendes Jahr	2015 bis 2035	Kalenderjahr, 2015 bis 2035. Ohne Angabe das laufende Jahr.
`land`	Text	nein		BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH	Kürzel des Bundeslands, zum Beispiel HE; der Name wie Hessen geht auch. Ohne Angabe oder mit DE: alle Länder.

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
`jahr`	Ganzzahl	Kalenderjahr
`land`	Text oder null	Kürzel des Bundeslands
`land_name`	Text	Name des Bundeslands
`anzahl`	Ganzzahl	Zahl der Feiertage
`anzahl_landesweit_montag_bis_freitag`	Ganzzahl	Landesweite Feiertage von Montag bis Freitag
`feiertage`	Liste	Datum, Name, Wochentag, regional, sonntag
`rechtsgrundlage`	Text	Feiertagsgesetz des Landes
`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
`hinweise`	Liste	Grenzen der Werte oder der Berechnung, in Sätzen
`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

Beispiel

Aufruf mit jahr = 2027, land = HE. Die Antwort erzeugt derselbe Code, der auch die API beantwortet.

api.quellenkontor.dev/v1/hr/feiertage?jahr=2027&land=HE

Zur API-Doku →

curl "https://api.quellenkontor.dev/v1/hr/feiertage?jahr=2027&land=HE" \
  -H "Authorization: Bearer $QK_KEY"

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

const qk = new Quellenkontor(process.env.QK_KEY);
const daten = await qk.hr.feiertage({ jahr: 2027, land: "HE" });

import os
from quellenkontor import Quellenkontor

qk = Quellenkontor(api_key=os.environ["QK_KEY"])
daten = qk.hr.feiertage(jahr=2027, land="HE")

$ qk feiertage --jahr 2027 --land HE

{
  "name": "hr_feiertage",
  "arguments": {
    "jahr": 2027,
    "land": "HE"
  }
}

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

Antwort200 OK · JSON

{
  "datensatz": "feiertage",
  "jahr": 2027,
  "land": "HE",
  "land_name": "Hessen",
  "anzahl": 10,
  "anzahl_landesweit_montag_bis_freitag": 6,
  "feiertage": [
    {
      "datum": "2027-01-01",
      "id": "neujahr",
      "name": "Neujahr",
      "wochentag": "Freitag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2027-03-26",
      "id": "karfreitag",
      "name": "Karfreitag",
      "wochentag": "Freitag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2027-03-29",
      "id": "ostermontag",
      "name": "Ostermontag",
      "wochentag": "Montag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2027-05-01",
      "id": "tag_der_arbeit",
      "name": "Tag der Arbeit",
      "wochentag": "Samstag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2027-05-06",
      "id": "christi_himmelfahrt",
      "name": "Christi Himmelfahrt",
      "wochentag": "Donnerstag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2027-05-17",
      "id": "pfingstmontag",
      "name": "Pfingstmontag",
      "wochentag": "Montag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2027-05-27",
      "id": "fronleichnam",
      "name": "Fronleichnam",
      "wochentag": "Donnerstag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2027-10-03",
      "id": "tag_der_deutschen_einheit",
      "name": "Tag der Deutschen Einheit",
      "wochentag": "Sonntag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2027-12-25",
      "id": "erster_weihnachtstag",
      "name": "1. Weihnachtstag",
      "wochentag": "Samstag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2027-12-26",
      "id": "zweiter_weihnachtstag",
      "name": "2. Weihnachtstag",
      "wochentag": "Sonntag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    }
  ],
  "rechtsgrundlage": "Hessisches Feiertagsgesetz (HFeiertagsG)",
  "quelle": {
    "titel": "Hessisches Feiertagsgesetz (HFeiertagsG), Hessen",
    "url": "https://www.rv.hessenrecht.hessen.de/bshe/document/jlr-FeiertGHE1952pP1"
  },
  "quellen": [
    {
      "titel": "Hessisches Feiertagsgesetz (HFeiertagsG), Hessen",
      "url": "https://www.rv.hessenrecht.hessen.de/bshe/document/jlr-FeiertGHE1952pP1"
    }
  ],
  "hinweise": [
    "Regionale Feiertage gelten nur in Teilen des Landes und sind mit regional: true gekennzeichnet.",
    "sonntag: true steht für gesetzliche Feiertage, die immer auf einen Sonntag fallen. Das ist für Zuschläge nach § 3b EStG wichtig.",
    "Einmalige Feiertage sind enthalten, soweit sie bis zum Datenstand beschlossen sind. Neue Beschlüsse trägt der wöchentliche Prüflauf nach."
  ],
  "stand": "2026-09-23",
  "lizenz": "Berechnung nach den genannten Normen. Nutzung nach den Nutzungsbedingungen von Quellenkontor.",
  "zitat": "Gesetzliche Feiertage 2027 in Hessen: 10, davon 6 landesweit von Montag bis Freitag. Landesweit: Neujahr Fr 01.01., Karfreitag Fr 26.03., Ostermontag Mo 29.03., Tag der Arbeit Sa 01.05., Christi Himmelfahrt Do 06.05., Pfingstmontag Mo 17.05., Fronleichnam Do 27.05., Tag der Deutschen Einheit So 03.10., 1. Weihnachtstag Sa 25.12., 2. Weihnachtstag So 26.12.. Regionale Feiertage stehen in der Antwort. Rechtsgrundlage: Hessisches Feiertagsgesetz (HFeiertagsG). Quelle: Hessisches Feiertagsgesetz (HFeiertagsG), Hessen, https://www.rv.hessenrecht.hessen.de/bshe/document/jlr-FeiertGHE1952pP1. Daten: Quellenkontor (quellenkontor.dev).",
  "datenstand": "2026-09-23.1"
}

Fehlerfälle

Status	Code	Wann
400	`ungueltiger_parameter`	falsches Format oder Wert außerhalb von: jahr (2015 bis 2035); land (BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH)
400	`unbekannter_parameter`	Parameter, den es für diesen Datensatz nicht gibt
404	`kein_wert`	außerhalb der Abdeckung (2015 bis 2035) 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_feiertage:

inputSchema

{
  "type": "object",
  "properties": {
    "jahr": {
      "description": "Kalenderjahr, 2015 bis 2035. Ohne Angabe das laufende Jahr.",
      "type": "integer",
      "minimum": 2015,
      "maximum": 2035,
      "examples": [
        2027
      ]
    },
    "land": {
      "description": "Kürzel des Bundeslands, zum Beispiel HE; der Name wie Hessen geht auch. Ohne Angabe oder mit DE: alle Länder.",
      "type": "string",
      "enum": [
        "BW",
        "BY",
        "BE",
        "BB",
        "HB",
        "HH",
        "HE",
        "MV",
        "NI",
        "NW",
        "RP",
        "SL",
        "SN",
        "ST",
        "SH",
        "TH"
      ],
      "examples": [
        "HE"
      ]
    }
  },
  "required": [],
  "additionalProperties": false
}

Quelle und Stand

Angabe	Inhalt
Quelle	Feiertagsgesetze der Länder
Lizenz	Werte aus amtlichen Werken (§ 5 UrhG). Nutzung der Zusammenstellung nach den Nutzungsbedingungen von Quellenkontor.
Aktualisierung	bei Gesetzesänderung
Abdeckung	Deutschland, 2015 bis 2035
Zuletzt geprüft	23.09.2026
Nächste erwartete Änderung	bei Änderung eines Landesgesetzes

Überblick mit Tabellen und Fragen zum Datensatz: Gesetzliche Feiertage. Einen Fehler meldest du über das Kontaktformular.

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