DESign inStart for free
Use case · For HR software

Account for public holidays by location in shift planning

Public holidays for each location in the plan automatically, regional holidays included.

For shift planning, you need the public holidays of the state (Bundesland) where a location is, not those of the head office. Bavaria, for example, has 14 public holidays in 2026, including regional ones. Other states have fewer. The API returns them by state and year, with the weekday.

1

Assign each location to its state.

2

Fetch the public holidays for the planning year for each state and check regional holidays for each location.

3

Mark days off and premiums in the plan and recalculate target hours.

The location decides

What counts is the public holiday law (Feiertagsgesetz) of the state where the work is done. In a company based in Hamburg with a warehouse in Bavaria, Epiphany (Heilige Drei Könige) is a day off in Bavaria but not in Hamburg.

Regional holidays apply only in part of a state, such as Corpus Christi (Fronleichnam) in parts of Saxony and Thuringia or the Augsburg Peace Festival (Augsburger Friedensfest). The API marks them and says where they apply. You decide once, when you assign a location, whether it is affected.

What planning does with it

  • Block days off for each location in the shift plan, or staff them with a premium.
  • Recalculate target hours per month with the working days calculator.
  • Treat Christmas Eve and New Year's Eve separately: they are not public holidays, but from 2 p.m. they count like holidays for premiums under § 3b of the Income Tax Act (EStG).

Plan years ahead

Public holidays are available from 2015 to 2035, movable and fixed, plus one-off holidays as soon as a state has adopted them. The tables for the current and the next year are on the public holidays page.

What the call looks like

Example with the dataset Public holidays. The response comes from the same code as the API.

api.quellenkontor.dev/v1/hr/feiertage?land=BY
Zur API-Doku →
curl "https://api.quellenkontor.dev/v1/hr/feiertage?land=BY" \
  -H "Authorization: Bearer $QK_KEY"
Antwort200 OK · JSON
{
  "datensatz": "feiertage",
  "jahr": 2026,
  "land": "BY",
  "land_name": "Bayern",
  "anzahl": 14,
  "anzahl_landesweit_montag_bis_freitag": 9,
  "feiertage": [
    {
      "datum": "2026-01-01",
      "id": "neujahr",
      "name": "Neujahr",
      "wochentag": "Donnerstag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-01-06",
      "id": "heilige_drei_koenige",
      "name": "Heilige Drei Könige",
      "wochentag": "Dienstag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-04-03",
      "id": "karfreitag",
      "name": "Karfreitag",
      "wochentag": "Freitag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-04-06",
      "id": "ostermontag",
      "name": "Ostermontag",
      "wochentag": "Montag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-05-01",
      "id": "tag_der_arbeit",
      "name": "Tag der Arbeit",
      "wochentag": "Freitag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-05-14",
      "id": "christi_himmelfahrt",
      "name": "Christi Himmelfahrt",
      "wochentag": "Donnerstag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-05-25",
      "id": "pfingstmontag",
      "name": "Pfingstmontag",
      "wochentag": "Montag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-06-04",
      "id": "fronleichnam",
      "name": "Fronleichnam",
      "wochentag": "Donnerstag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-08-08",
      "id": "augsburger_friedensfest",
      "name": "Augsburger Hohes Friedensfest",
      "wochentag": "Samstag",
      "regional": true,
      "regional_hinweis": "nur im Stadtgebiet Augsburg",
      "sonntag": false
    },
    {
      "datum": "2026-08-15",
      "id": "mariae_himmelfahrt",
      "name": "Mariä Himmelfahrt",
      "wochentag": "Samstag",
      "regional": true,
      "regional_hinweis": "nur in Gemeinden mit überwiegend katholischer Bevölkerung",
      "sonntag": false
    },
    {
      "datum": "2026-10-03",
      "id": "tag_der_deutschen_einheit",
      "name": "Tag der Deutschen Einheit",
      "wochentag": "Samstag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-11-01",
      "id": "allerheiligen",
      "name": "Allerheiligen",
      "wochentag": "Sonntag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-12-25",
      "id": "erster_weihnachtstag",
      "name": "1. Weihnachtstag",
      "wochentag": "Freitag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    },
    {
      "datum": "2026-12-26",
      "id": "zweiter_weihnachtstag",
      "name": "2. Weihnachtstag",
      "wochentag": "Samstag",
      "regional": false,
      "regional_hinweis": null,
      "sonntag": false
    }
  ],
  "rechtsgrundlage": "Gesetz über den Schutz der Sonn- und Feiertage (Feiertagsgesetz, FTG)",
  "quelle": {
    "titel": "Gesetz über den Schutz der Sonn- und Feiertage (Feiertagsgesetz, FTG), Bayern",
    "url": "https://www.gesetze-bayern.de/Content/Document/BayFTG-1"
  },
  "quellen": [
    {
      "titel": "Gesetz über den Schutz der Sonn- und Feiertage (Feiertagsgesetz, FTG), Bayern",
      "url": "https://www.gesetze-bayern.de/Content/Document/BayFTG-1"
    }
  ],
  "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 2026 in Bayern: 14, davon 9 landesweit von Montag bis Freitag. Landesweit: Neujahr Do 01.01., Heilige Drei Könige Di 06.01., Karfreitag Fr 03.04., Ostermontag Mo 06.04., Tag der Arbeit Fr 01.05., Christi Himmelfahrt Do 14.05., Pfingstmontag Mo 25.05., Fronleichnam Do 04.06., Tag der Deutschen Einheit Sa 03.10., Allerheiligen So 01.11., 1. Weihnachtstag Fr 25.12., 2. Weihnachtstag Sa 26.12.. Regionale Feiertage stehen in der Antwort. Rechtsgrundlage: Gesetz über den Schutz der Sonn- und Feiertage (Feiertagsgesetz, FTG). Quelle: Gesetz über den Schutz der Sonn- und Feiertage (Feiertagsgesetz, FTG), Bayern, https://www.gesetze-bayern.de/Content/Document/BayFTG-1. Daten: Quellenkontor (quellenkontor.dev).",
  "datenstand": "2026-09-23.1"
}

Frequently asked questions

Which public holidays count for a location?

Those of the state where the location is. Regional holidays only count if the location is in the area concerned.

Are Christmas Eve and New Year's Eve public holidays?

No, neither is a public holiday. The contract or collective agreement decides whether employees get the day off.

How far ahead are public holidays available?

Up to 2035. The weekly check adds new one-off holidays as soon as a state has adopted them.

Datasets used

Public holidays

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

APIMCPwhen the law changes

Working days calculator

Working days between two dates by state, without weekends and public holidays.

APIMCPwhen the law changes

Related use cases

Calculate a prorated salary by working days when someone joins or leaves

When someone joins or leaves mid-month, count the working days by state and prorate the salary.

Enter maternity protection periods in HR software automatically

The expected due date gives you the start and end of the maternity protection period (Mutterschutzfrist) in your system.