Public Holidays gives you accurate public holiday data for 100+ countries in seconds. Look up every holiday in a year, check whether a specific date is a holiday, or find the next upcoming holiday from any starting date. It covers national, regional, and bank holidays for countries across every continent.
This is useful anywhere your work or automation needs to be holiday-aware — scheduling meetings, planning campaigns, sending date-sensitive communications, or building calendar integrations that respect local public holidays.
What you can do
- holidays — get the full list of public holidays for any country and year, with names, dates, and fixed/variable status
- is_holiday — check whether a specific date is a public holiday in a given country
- next_holiday — find the next upcoming holiday from today or any given date
- supported_countries — list all supported countries with their ISO codes
Who it's for
Developers building scheduling tools, operations teams planning around international holidays, marketers timing campaigns for global audiences, and anyone who needs to know whether a given date is a working day in a specific country.
How to use it
- Call holidays with a country code (e.g. US, GB, DE, AU) and a year to get the full holiday calendar.
- Call is_holiday with a specific date and country code to check a single date before scheduling something.
- Call next_holiday with just a country code to find out what's coming up next from today.
Getting started
Use ISO 3166-1 alpha-2 country codes (two-letter codes like US, GB, FR). Call supported_countries first if you're unsure whether a country is covered.
