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

Example: England and Wales in 2027, when Christmas falls at a weekend

Calendar name
The country or region in words.
United Kingdom: England and Wales
Count
How many holidays there are.
8
Days off
The dates that are not worked, in order: each holiday, or the day it is observed on.
2027-01-01, 2027-03-26, 2027-03-29, 2027-05-03, 2027-05-31, 2027-08-30, 2027-12-27, 2027-12-28
Source
The law or official list the rules come from.
GOV.UK: UK bank holidays
Source URL
Its address.
https://www.gov.uk/bank-holidays

Holidays

DateWeekdayName
2027-01-01FridayNew Year's Day
2027-03-26FridayGood Friday
2027-03-29MondayEaster Monday
2027-05-03MondayEarly May bank holiday
2027-05-31MondaySpring bank holiday
2027-08-30MondaySummer bank holiday
2027-12-27MondayChristmas Day (substitute day)
2027-12-28TuesdayBoxing Day (substitute day)

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": "GB-ENG",
    "year": 2027
  }'
The same call in Python
import os

import requests

payload = {
    "calendar": "GB-ENG",
    "year": 2027,
}
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": "GB-ENG",
    "year": 2027,
};
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.