Reference

Reference: Public holidays

Public holidays by state and year, with regional holidays marked.

The statutory public holidays (gesetzliche Feiertage) of the 16 federal states under the current holiday laws, calculated for 2015 to 2035, with weekday, regional holidays such as Corpus Christi in parts of Saxony and one-off holidays. Holidays that always fall on a Sunday are marked separately for premiums.

Endpoints and calls

Access	Call
REST API	`GET /hr/feiertage`
SDK JavaScript	`qk.hr.feiertage(…)`
SDK Python	`qk.hr.feiertage(…)`
CLI	`qk feiertage --jahr 2027 --land HE`
MCP tool	`hr_feiertage`

Parameters

Name	Type	Required	Default	Allowed	Description
`jahr`	year	no	laufendes Jahr	2015 to 2035	Calendar year, 2015 to 2035. Defaults to the current year.
`land`	text	no		BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH	State code, for example HE; the name such as Hessen also works. Without it or with DE: all states.

The API rejects unknown parameters with unbekannter_parameter. In addition there are format and trennzeichen, see CSV.

Response fields

Field	Type	Meaning
`datensatz`	Text	Dataset id
`jahr`	Integer	Calendar year
`land`	Text or null	State code
`land_name`	Text	Name of the state
`anzahl`	Integer	Number of public holidays
`anzahl_landesweit_montag_bis_freitag`	Integer	Statewide public holidays from Monday to Friday
`feiertage`	List	Date, name, weekday, regional, sonntag
`rechtsgrundlage`	Text	Law or ordinance
`quelle`	Object	Title and URL of the source the value is based on
`quellen`	List	All legal provisions the response is based on, with title and URL
`hinweise`	List	Limits of the values or the calculation, in sentences
`stand`	Date	Date of the last check against the source
`lizenz`	Text	Terms of use for the values
`zitat`	Text	Ready-made sentence for citing, with value, validity, legal basis and source
`datenstand`	Text	Id of the data snapshot: date and sequence number of the last changelog entry (/v1/aenderungen) affecting this dataset. The same datenstand means unchanged content, useful for auditors and for comparing two requests

Example

Call with jahr = 2027, land = HE. The response is generated by the same code that answers the API.

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"
  }
}

This is how an agent calls the tool. Server setup is described in the MCP docs.

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"
}

Error cases

Status	Code	When
400	`ungueltiger_parameter`	wrong format or a value outside: jahr (2015 to 2035); land (BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH)
400	`unbekannter_parameter`	a parameter this dataset does not have
404	`kein_wert`	outside the coverage (2015 to 2035) or the value for this period has not been promulgated yet
401, 429	see errors	all error codes

Schema for MCP

This is how the MCP server describes the arguments of the tool 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
}

Source and freshness

Item	Content
Source	Public holiday laws of the federal states (Feiertagsgesetze der Länder)
License	Values from official works (§ 5 UrhG). Use of the compilation under the Quellenkontor terms of use.
Updates	when the law changes
Coverage	Germany, 2015 to 2035
Last checked	September 23, 2026
Next expected change	when a state law changes

Overview with tables and questions about the dataset: Public holidays. Report an error through the contact form.

Something missing or unclear? Write to us and we will extend the docs.