curatedapi

Public holidays by country and year

The public holidays of a country or region in a year, worked out from the rules in its law, with the official source.

The country or region. Options: US: United States (federal holidays); GB-ENG: United Kingdom: England and Wales; GB-SCT: United Kingdom: Scotland; GB-NIR: United Kingdom: Northern Ireland; DE: Germany (the nine nationwide holidays); DE-BW: Germany: Baden-Württemberg; DE-BY: Germany: Bavaria; DE-BE: Germany: Berlin; DE-BB: Germany: Brandenburg; DE-HB: Germany: Bremen; DE-HH: Germany: Hamburg; DE-HE: Germany: Hesse; DE-MV: Germany: Mecklenburg-Vorpommern; DE-NI: Germany: Lower Saxony; DE-NW: Germany: North Rhine-Westphalia; DE-RP: Germany: Rhineland-Palatinate; DE-SL: Germany: Saarland; DE-SN: Germany: Saxony; DE-ST: Germany: Saxony-Anhalt; DE-SH: Germany: Schleswig-Holstein; DE-TH: Germany: Thuringia; FR: France (mainland); NL: Netherlands; IE: Ireland; BE: Belgium; AT: Austria; IT: Italy
The year.

Examples

Result: Bavaria in 2026

Calendar name
The country or region in words.
Germany: Bavaria
Count
How many holidays there are.
12
Days off
The dates that are not worked, in order: each holiday, or the day it is observed on.
2026-01-01, 2026-01-06, 2026-04-03, 2026-04-06, 2026-05-01, 2026-05-14, 2026-05-25, 2026-06-04, 2026-10-03, 2026-11-01, 2026-12-25, 2026-12-26
Source
The law or official list the rules come from.
Germany: the Unification Treaty (3 October) and each state's public holiday act (Feiertagsgesetz), as summarised by the Federal Ministry of the Interior
Source URL
Its address.
https://www.bmi.bund.de/DE/themen/verfassung/staatliche-symbole/nationale-feiertage/nationale-feiertage-node.html

Holidays

DateWeekdayNameLocal name
2026-01-01ThursdayNew Year's DayNeujahr
2026-01-06TuesdayEpiphanyHeilige Drei Könige
2026-04-03FridayGood FridayKarfreitag
2026-04-06MondayEaster MondayOstermontag
2026-05-01FridayLabour DayTag der Arbeit
2026-05-14ThursdayAscension DayChristi Himmelfahrt
2026-05-25MondayWhit MondayPfingstmontag
2026-06-04ThursdayCorpus ChristiFronleichnam
2026-10-03SaturdayDay of German UnityTag der Deutschen Einheit
2026-11-01SundayAll Saints' DayAllerheiligen
2026-12-25FridayChristmas Day1. Weihnachtstag
2026-12-26SaturdaySecond day of Christmas2. Weihnachtstag

Calculator date/holidays@1.

How it is calculated

fixed dates, n-th weekday of a month, and offsets from Easter Sunday (Gregorian computus); UK: a holiday at a weekend moves to the next working day

Lists the public holidays of a year for the United States (federal), the United Kingdom (England and Wales, Scotland, Northern Ireland), Germany (nationwide and each of the 16 states), France, the Netherlands, Ireland, Belgium, Austria and Italy. Dates come from the rules themselves: fixed dates, weekday rules such as the last Monday in May, and days counted from Easter. UK substitute days and the day US federal offices close when a holiday falls at a weekend are included. Countries that set some holidays year by year, by decree or by the moon, are not covered, because those dates cannot be worked out ahead.

  • Holiday calendars cover 2020 to 2030. They follow the rules in each country's law, plus the one-off days that were proclaimed for a single year. A government can still add or move a day for a year ahead; such a change is added here when it becomes law.
  • Holidays that apply only in some towns or districts are not included (for example Assumption Day in most of Bavaria, Corpus Christi in parts of Saxony and Thuringia, and Good Friday in Alsace-Moselle).
  • A holiday that falls at a weekend is still listed. Only the United Kingdom moves it to a weekday by law, and US federal offices close on the nearest weekday; in the other countries here it is not replaced.
  • The Netherlands: these are the official holidays, but no law gives employees the day off; that depends on the collective agreement or contract.

References

Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.

Use it from your code

POST /v1/calc/date/holidaysVersion 1
curl https://api.curatedapi.com/v1/calc/date/holidays \
  -H "Authorization: Bearer $CURATEDAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "calendar": "DE-BY",
    "year": 2026
  }'
The same call in Python
import os

import requests

payload = {
    "calendar": "DE-BY",
    "year": 2026,
}
response = requests.post(
    "https://api.curatedapi.com/v1/calc/date/holidays",
    headers={"Authorization": f"Bearer {os.environ['CURATEDAPI_KEY']}"},
    json=payload,
    timeout=10,
)
print(response.json()["result"])
The same call in JavaScript
const payload = {
    "calendar": "DE-BY",
    "year": 2026,
};
const response = await fetch("https://api.curatedapi.com/v1/calc/date/holidays", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CURATEDAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify(payload),
});
console.log((await response.json()).result);

MCP tool calc_date_holidays at https://mcp.curatedapi.com. Inputs, outputs and errors in the API reference.

Put it on your website

<div data-curatedapi-widget="date/holidays" data-key="capi_public_…"></div>
<script src="https://widgets.curatedapi.com/v1/widget.js" async></script>

Use a public key registered for your site. Calculations are billed like API calls. How widgets work.

Related calculators

Add this calculator to your website

Paste two lines into your page and your visitors get this calculator. Each use counts as one call on your plan, the same as the API.

Free for up to 1,000 uses a month. 50,000 uses a month cost $9.00 on the Starter plan.