How do I connect OpenHolidays to Lodol?

Authenticate OpenHolidays once from your workspace and every action and trigger it supports becomes available to drop into a workflow. There is no glue code to write or maintain.

All integrations

OpenHolidays

CalendarsUtilities

Look up public holidays and school holidays for 36 countries from a workflow. List a country's public holidays for a year or a date range, get the next one coming up, check whether a date, or today, is a holiday, and count the working days between two dates with weekends and holidays taken out. School holidays are the unusual part: term breaks come back as spans of days, down to the state, canton or school zone that keeps them, so a workflow can plan around the weeks parents are away. One step also answers a date across every country at once, for a team spread over several. Names come back in any of 30 languages. Every action reads: nothing here changes anything. No account or API key required.

Get Started Browse all integrations

12 actions

Actions

Steps your workflow can run in OpenHolidays.

List public holidaysList a country's public holidays. Leave the dates empty for this calendar year, or set them for a quarter, a sprint or any window up to three years. Each holiday comes back with its date, the weekday, whether it applies nationwide and which regions it applies in. Choosing a state or canton keeps that region's own holidays alongside the national ones, which is the calendar someone working there actually keeps.

List school holidaysList a country's school holidays, which is the thing almost no holiday API publishes. Each one is a span of days rather than a single date, so a fortnight of Easter holidays comes back as one entry with its start, its end and how many days it runs. Term dates vary by region and, in a few countries, by zone or type of school, so pick those to get the dates a particular school really keeps. Use it to plan around the weeks parents will be taking off.

Get the next public holidayGet the single next public holiday in a country, returned flat so a later step can read the name, the date and how many days away it is without indexing into a list. Answers 'when is the next day off' in one step, so a scheduled workflow can act a fortnight before one. If nothing falls in the year ahead it returns found = false rather than failing.

Check whether a date is a holidayCheck one date and get four plain answers: is it a public holiday, are the schools out, is it a weekend, is it a working day. Use it to gate a workflow on whether an office is open, or to hold a send that would land on a day off. It defaults to today, so 'is today a holiday' needs nothing but the country. Only Public holidays count as a day off unless you say otherwise, and anything else marked on the date is reported separately rather than silently dropped.

Count working daysCount the working days between two dates, with weekends and public holidays taken out. Use it for a delivery date, an SLA window, a payroll period or a project estimate. It also hands back which holidays cost a working day and which fell at a weekend anyway. Half days count as half, and the weekend itself is a setting, so a business that trades on Saturday counts its own.

Find which countries have a public holidayAsk one date of every country at once and get back the ones with a public holiday that day, in a single step rather than one per country. Use it to tell a global team who is off today, or to hold a send that would land on a holiday somewhere. Defaults to today, and can be narrowed to the countries you operate in.

Find which countries have schools outAsk one date of every country at once and get back the ones whose schools are closed that day. School holidays are staggered across Europe, so this is how to see, in one step, which offices will be thin on the ground in a given week. Defaults to today, and can be narrowed to the countries you operate in.

List countriesList every country OpenHolidays has holiday data for, with its ISO 3166-1 code and official languages, sorted by name. This is the same list every country dropdown here is built from, and the way to check whether somewhere is covered before a workflow depends on it. Coverage is 36 countries, mostly European. Search it by name or by code.

List a country's regionsList the states, cantons, regions or municipalities a country publishes holidays for, largest areas first. Use it to find the code a region filter wants, or to see how far down a country's calendar varies: Germany stops at its sixteen federal states, Switzerland reaches individual municipalities. Each region carries its ISO 3166-2 code too, which is not always the same as the code this API answers to.

List school holiday groupsList the zones and school types a country splits its school holidays by. Belgium sets its by language community, the Netherlands by region, and Switzerland and Germany by type of school, so primary and vocational schools break on different days. This is how to find the code for one. The other 32 countries publish none, and an empty result is the normal answer for them rather than a fault.

List languagesList the languages OpenHolidays publishes holiday names in, with their ISO 639-1 codes. Useful when a workflow has to write to people in their own language: pick the code here, then set it as the language on any other action. Not every holiday is translated into every language, and where one is not the original name is returned rather than a blank.

Check which years are coveredFind out how far back and how far forward a country's holiday data reaches, for public and school holidays separately. The two rarely match: Germany's public holidays run from 2020 while its school holidays start a decade earlier. Ask this before a workflow depends on a year, because a year outside the data comes back empty rather than as an error. It is also the one-step check that the connection works.