Public holidays by country and year API
The public holidays of a country or region in a year, worked out from the rules in its law, with the official source.
POST https://api.curatedapi.com/v1/calc/date/holidays
- Version 1
- MCP tool
calc_date_holidays - Try it in the browser
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.
Formula
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
- 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.
Inputs
Send numbers as strings to keep every digit. options sets precision and rounding (see numbers and rounding).
| Input | Type | Description |
|---|---|---|
calendar required |
US | GB-ENG | GB-SCT | GB-NIR | DE | DE-BW | DE-BY | DE-BE | DE-BB | DE-HB | DE-HH | DE-HE | DE-MV | DE-NI | DE-NW | DE-RP | DE-SL | DE-SN | DE-ST | DE-SH | DE-TH | FR | NL | IE | BE | AT | IT | 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 |
year required |
integer | The year. Allowed: >= 2020 and <= 2030. |
Result
Under result in the answer, next to exactness, precision, inputs, formula, references and warnings.
| Result | Type | Description |
|---|---|---|
calendar_name | string | The country or region in words. |
count | integer | How many holidays there are. |
holidays | list of object | The holidays in date order. |
days_off | list of string | The dates that are not worked, in order: each holiday, or the day it is observed on. |
source | string | The law or official list the rules come from. |
source_url | string | Its address. |
Examples
England and Wales in 2027, when Christmas falls at a weekend
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
}'
{
"calculator": "date/holidays@1",
"result": {
"calendar_name": "United Kingdom: England and Wales",
"count": 8,
"holidays": [
{
"date": "2027-01-01",
"weekday": "Friday",
"name": "New Year's Day"
},
{
"date": "2027-03-26",
"weekday": "Friday",
"name": "Good Friday"
},
{
"date": "2027-03-29",
"weekday": "Monday",
"name": "Easter Monday"
},
{
"date": "2027-05-03",
"weekday": "Monday",
"name": "Early May bank holiday"
},
{
"date": "2027-05-31",
"weekday": "Monday",
"name": "Spring bank holiday"
},
{
"date": "2027-08-30",
"weekday": "Monday",
"name": "Summer bank holiday"
},
{
"date": "2027-12-27",
"weekday": "Monday",
"name": "Christmas Day (substitute day)"
},
{
"date": "2027-12-28",
"weekday": "Tuesday",
"name": "Boxing Day (substitute day)"
}
],
"days_off": [
"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": "GOV.UK: UK bank holidays",
"source_url": "https://www.gov.uk/bank-holidays"
},
"exactness": {},
"precision": null,
"inputs": {
"calendar": "GB-ENG",
"year": 2027
},
"formula": "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",
"references": [
{
"title": "5 U.S.C. 6103, as listed by the US Office of Personnel Management",
"url": "https://www.opm.gov/policy-data-oversight/pay-leave/federal-holidays/"
},
{
"title": "GOV.UK: UK bank holidays",
"url": "https://www.gov.uk/bank-holidays"
},
{
"title": "Germany: the Unification Treaty (3 October) and each state's public holiday act (Feiertagsgesetz), as summarised by the Federal Ministry of the Interior",
"url": "https://www.bmi.bund.de/DE/themen/verfassung/staatliche-symbole/nationale-feiertage/nationale-feiertage-node.html"
},
{
"title": "Code du travail, article L3133-1, as explained by Service-Public.fr",
"url": "https://www.service-public.gouv.fr/particuliers/vosdroits/F2405"
},
{
"title": "Government of the Netherlands: official public holidays",
"url": "https://www.rijksoverheid.nl/onderwerpen/arbeidsovereenkomst-en-cao/vraag-en-antwoord/officiele-feestdagen"
},
{
"title": "Organisation of Working Time Act 1997, as explained by Citizens Information",
"url": "https://www.citizensinformation.ie/en/employment/employment-rights-and-conditions/leave-and-holidays/public-holidays/"
},
{
"title": "Belgian Federal Public Service Employment: the ten statutory public holidays",
"url": "https://employment.belgium.be/en/themes/international/posting/working-conditions-be-respected-case-posting-belgium/public-holidays"
},
{
"title": "Feiertagsruhegesetz 1957, section 1 (Austrian legal information system)",
"url": "https://www.ris.bka.gv.at/GeltendeFassung.wxe?Abfrage=Bundesnormen&Gesetzesnummer=10008168"
},
{
"title": "Law 260 of 27 May 1949 and later amendments, as listed by the Italian government",
"url": "https://presidenza.governo.it/ufficio_cerimoniale/cerimoniale/giornate.html"
}
],
"warnings": []
}
Bavaria in 2026
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
}'
{
"calculator": "date/holidays@1",
"result": {
"calendar_name": "Germany: Bavaria",
"count": 12,
"holidays": [
{
"date": "2026-01-01",
"weekday": "Thursday",
"name": "New Year's Day",
"local_name": "Neujahr"
},
{
"date": "2026-01-06",
"weekday": "Tuesday",
"name": "Epiphany",
"local_name": "Heilige Drei Könige"
},
{
"date": "2026-04-03",
"weekday": "Friday",
"name": "Good Friday",
"local_name": "Karfreitag"
},
{
"date": "2026-04-06",
"weekday": "Monday",
"name": "Easter Monday",
"local_name": "Ostermontag"
},
{
"date": "2026-05-01",
"weekday": "Friday",
"name": "Labour Day",
"local_name": "Tag der Arbeit"
},
{
"date": "2026-05-14",
"weekday": "Thursday",
"name": "Ascension Day",
"local_name": "Christi Himmelfahrt"
},
{
"date": "2026-05-25",
"weekday": "Monday",
"name": "Whit Monday",
"local_name": "Pfingstmontag"
},
{
"date": "2026-06-04",
"weekday": "Thursday",
"name": "Corpus Christi",
"local_name": "Fronleichnam"
},
{
"date": "2026-10-03",
"weekday": "Saturday",
"name": "Day of German Unity",
"local_name": "Tag der Deutschen Einheit"
},
{
"date": "2026-11-01",
"weekday": "Sunday",
"name": "All Saints' Day",
"local_name": "Allerheiligen"
},
{
"date": "2026-12-25",
"weekday": "Friday",
"name": "Christmas Day",
"local_name": "1. Weihnachtstag"
},
{
"date": "2026-12-26",
"weekday": "Saturday",
"name": "Second day of Christmas",
"local_name": "2. Weihnachtstag"
}
],
"days_off": [
"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": "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": "https://www.bmi.bund.de/DE/themen/verfassung/staatliche-symbole/nationale-feiertage/nationale-feiertage-node.html"
},
"exactness": {},
"precision": null,
"inputs": {
"calendar": "DE-BY",
"year": 2026
},
"formula": "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",
"references": [
{
"title": "5 U.S.C. 6103, as listed by the US Office of Personnel Management",
"url": "https://www.opm.gov/policy-data-oversight/pay-leave/federal-holidays/"
},
{
"title": "GOV.UK: UK bank holidays",
"url": "https://www.gov.uk/bank-holidays"
},
{
"title": "Germany: the Unification Treaty (3 October) and each state's public holiday act (Feiertagsgesetz), as summarised by the Federal Ministry of the Interior",
"url": "https://www.bmi.bund.de/DE/themen/verfassung/staatliche-symbole/nationale-feiertage/nationale-feiertage-node.html"
},
{
"title": "Code du travail, article L3133-1, as explained by Service-Public.fr",
"url": "https://www.service-public.gouv.fr/particuliers/vosdroits/F2405"
},
{
"title": "Government of the Netherlands: official public holidays",
"url": "https://www.rijksoverheid.nl/onderwerpen/arbeidsovereenkomst-en-cao/vraag-en-antwoord/officiele-feestdagen"
},
{
"title": "Organisation of Working Time Act 1997, as explained by Citizens Information",
"url": "https://www.citizensinformation.ie/en/employment/employment-rights-and-conditions/leave-and-holidays/public-holidays/"
},
{
"title": "Belgian Federal Public Service Employment: the ten statutory public holidays",
"url": "https://employment.belgium.be/en/themes/international/posting/working-conditions-be-respected-case-posting-belgium/public-holidays"
},
{
"title": "Feiertagsruhegesetz 1957, section 1 (Austrian legal information system)",
"url": "https://www.ris.bka.gv.at/GeltendeFassung.wxe?Abfrage=Bundesnormen&Gesetzesnummer=10008168"
},
{
"title": "Law 260 of 27 May 1949 and later amendments, as listed by the Italian government",
"url": "https://presidenza.governo.it/ufficio_cerimoniale/cerimoniale/giornate.html"
}
],
"warnings": []
}
References
- 5 U.S.C. 6103, as listed by the US Office of Personnel Management
- GOV.UK: UK bank holidays
- Germany: the Unification Treaty (3 October) and each state's public holiday act (Feiertagsgesetz), as summarised by the Federal Ministry of the Interior
- Code du travail, article L3133-1, as explained by Service-Public.fr
- Government of the Netherlands: official public holidays
- Organisation of Working Time Act 1997, as explained by Citizens Information
- Belgian Federal Public Service Employment: the ten statutory public holidays
- Feiertagsruhegesetz 1957, section 1 (Austrian legal information system)
- Law 260 of 27 May 1949 and later amendments, as listed by the Italian government
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.
Errors share one format; see errors. Billing, retries and batches work the same for every endpoint.