Public holiday
Open data · free API · calendar feeds
Every day off, one API.
Public holidays for 247 countries and school holidays by region and school district, as open data, a free API and calendar feeds you can subscribe to.
Public holidays: © python-holidays contributors, MIT · synced every week
Next public holiday
01. Coverage
247 countries, through 2036.
Public holidays for every country and region python-holidays covers, from 2020 to 2036. School holidays from official open data where a government publishes it, researched calendars where none does.
Countries
247
624 states, provinces and regions included
Window
2036
Recomputed weekly, history back to 2020 kept
December
Lower Saxony, public and school holidays in one calendar.
Public holidaySchool holidayDE-NI
School holidays
15
countries, regions and school districts
Names in every language the source offers
deErster Weihnachtstag
enChristmas Day
Missing a language? The API falls back to the base language, then English, then the local name.
Sync
Weekly
From python-holidays and official open data, with a guard against broken releases
02. School calendars
Find your school’s holidays, subscribe once.
Search a region or a US school district, then add its holidays to Apple Calendar, Google Calendar or Outlook. The feed updates itself when the calendar changes.
US school districts searchable
19,636
With a verified calendar
172
US public school students covered
20.5%9.3M students in districts with a verified calendar
03. API
One request, clean JSON.
Query by country, region and date range. No key, no sign-up. Every holiday comes with its local name, translations, category and source.
- Region or nation, never both. A region returns its complete set, nationwide days included.
- is_observed marks a shifted date that is still a day off.
- is_estimated marks dates that depend on moon sighting and can still move.
- Every row knows its source and licence.
RequestSHELL
# Public holidays in Lower Saxony, 2026 curl https://api.holibase.org/v1/public-holidays/DE/2026?subdivision=DE-NI
Response, first holidayJSON
{
"date": "2026-01-01",
"name": "New Year's Day",
"local_name": "Neujahr",
"category": "public",
"scope": "national",
"is_observed": false,
"is_estimated": false,
"subdivision_code": "DE-NI",
"source_id": "python-holidays"
}
04. Sources
Where the school holidays come from.
Official open data first. Where a government publishes nothing machine-readable, Holibase researches the calendar from the authority’s own documents and marks it until it is verified.
Start with one request.
Open source code, open data, a public read API.