Public Holidays
Holidays for any country
On it. Running Public Holidays now and I'll bring the results straight back here.
Try asking
About
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.
Get all public holidays for a country and year
Check if a specific date is a public holiday in a given country
Find the next upcoming public holiday for a country from today or from…
List all countries supported by the public holidays API with their ISO…
Get all public holidays for a country and year. Returns holiday names, dates, types, and whether they are fixed or variable dates. Supports 100+ countries by ISO 3166-1 alpha-2 code.
Check if a specific date is a public holiday in a given country. Returns the holiday details if it is, or confirms it is a regular day.
Find the next upcoming public holiday for a country from today or from a specified date. Useful for scheduling and planning around holidays.
List all countries supported by the public holidays API with their ISO codes and names.
- Countries without holiday data now get a clear message instead of a failed call
- Added subtitle, expanded description, and agent instructions
- Remove provider branding from user-facing output
- Initial release
Related
Questions
Can I get the full holiday calendar for one country and year?
Yes. Use `holidays` with an ISO 3166-1 alpha-2 country code like `US` or `GB`, plus the year you want.
How do I check whether one date is a holiday?
Use `is_holiday` with the country code and date. It tells you whether the day is a public holiday and returns the holiday details if it is.
How do I find the next upcoming holiday?
Use `next_holiday` from today or from any date you care about. It is the fastest way to plan around the next break in a market.
What if I am not sure which country codes are supported?
Call `supported_countries` first. It returns the supported countries with their ISO codes so you can pick the right one quickly.