List holidays for a yearList a country's holidays for a whole calendar year, narrowed to a state or region, a month, a name or the holiday types you care about. Each holiday carries the date, the weekday, whether it applies nationally and which regions it applies in.
List upcoming holidaysList the holidays a country has coming up in the next 365 days, without having to work out which year they fall in. Each one carries how many days away it is, so a scheduled workflow can act a fortnight before one.
Get the next holidayGet the single next 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.
Check whether a date is a holidayCheck one date in one country and get three plain answers: is it a holiday, is it a weekend day, is it a working day. Only Public holidays count as a day off unless you say otherwise, and anything else marked on the date is reported separately.
List holidays between two datesList every holiday between two dates, whether or not they fall in the same year. A range that crosses new year is fetched year by year and trimmed, so a quarter or a sprint is a single step either way.
Count working daysCount the working days between two dates, with weekends and public holidays taken out: a delivery date, an SLA window, a payroll period or a project estimate. The weekend itself is a setting, so a Friday and Saturday week counts correctly.
Check whether today is a holidayAsk Nager.Date whether today is a public holiday in a country or one of its states, and get the holiday's name with the answer. Pick the UTC offset of the place you mean so 'today' is their today rather than UTC's.
List long weekendsList the long weekends a country's holidays make in a year: when each one starts and ends, how many days off it is, and which working days you would have to take off to join it up. Raise the bridge-day budget to find longer breaks.
List upcoming holidays worldwideList every country's holidays in the next seven days, in one step rather than one per country. Tell a global team who is off this week, or hold a send that would land on a holiday somewhere.
List countriesList every country Nager.Date has holiday data for, with its ISO 3166-1 alpha-2 code. This is how you check whether somewhere is covered before a workflow depends on it.
Get a countryGet one country's names and land borders: the name in common use, the official one, the name in its own language, the region it sits in, and every country it shares a border with.
List a country's regionsList the states, provinces or nations within a country that have holidays of their own, each with the holidays that make it different from the rest. This is where the ISO 3166-2 code a region filter wants comes from.
Get the API versionGet the Nager.Date build serving the API, and the range of years the holiday endpoints cover right now. A one-step check that the connection works.
