Public Holidays Calendar

Get official public holidays for more than 150 countries and any year, with no API key and no rate limits. This actor computes holidays offline from a maintained rules library, so it keeps working with zero setup and zero maintenance.

Give it a list of country codes and a year range. It returns every public holiday with the date, the weekday it lands on, the holiday name, and the country. You can localize names into other languages and optionally pull in regional holidays for states and provinces.

What you get

Every run produces a clean table, one row per holiday, ready to export as JSON, CSV or Excel. National holidays come first, then regional ones if you ask for them.

Input

• Countries: one or more ISO 3166-1 alpha-2 codes, such as US, GB or DE.
• Start year and end year: the range of calendar years to cover. Use the same value for a single year.
• Language: an optional language code for localized names, such as de or fr. Leave it empty to use each country's default language.
• Include regional holidays: add state, province or region specific holidays, each tagged with its subdivision code.

Example input:

{
    "countries": ["US", "GB", "CA", "AU", "DE", "FR"],
    "startYear": 2026,
    "endYear": 2026,
    "language": "",
    "includeSubdivisions": false
}

Output

Each item in the dataset looks like this:

{
    "country": "US",
    "countryName": "United States",
    "subdivision": null,
    "subdivisionName": null,
    "year": 2026,
    "date": "2026-01-01",
    "weekday": "Thursday",
    "holidayName": "New Year's Day",
    "language": "en"
}

Fields:

Field	Description
country	ISO 3166-1 alpha-2 country code
countryName	Full country name
subdivision	State or province code, or empty for national holidays
subdivisionName	Full name of the subdivision, when present
year	Calendar year of the holiday
date	Holiday date in ISO format, YYYY-MM-DD
weekday	Day of the week the holiday falls on
holidayName	Name of the holiday, localized if a language was set
language	Language actually used for the names

Ideas for using it

• Mark non working days in a booking, scheduling or delivery app.
• Plan payroll, invoicing and settlement around bank holidays.
• Build a travel or calendar product that knows local holidays.
• Compare holiday calendars across the countries where a team works.

How it works

The actor uses the open source holidays Python library, which encodes the rules for each country's public holidays, including moving dates like Easter. Everything is computed at runtime, so there is no external service to call, nothing to rate limit, and no key to manage. That is what keeps it maintenance free.

Notes

Country and language coverage follows the pinned version of the holidays library. If a country code is not supported it is skipped and noted in the log, and the run continues with the rest.