Skip to content
ToolRouter
Public Holidays icon

Public Holidays

Holidays for any country

DataFree

Use it in
Add to Claude
What are the public holidays in country for year? Is date a holiday there, and what is the next upcoming one?
Claude

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

  1. Call holidays with a country code (e.g. US, GB, DE, AU) and a year to get the full holiday calendar.
  2. Call is_holiday with a specific date and country code to check a single date before scheduling something.
  3. 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.

List Holidays

Get all public holidays for a country and year

Check Holiday

Check if a specific date is a public holiday in a given country

Next Holiday

Find the next upcoming public holiday for a country from today or from…

Supported Countries

List all countries supported by the public holidays API with their ISO…

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.