Connector Details
Type
Virtual machines, Single VM , BYOL
Runs on
Google Compute Engine
Last Update
24 October, 2024
Category
Nager.Date Connector
Overview
The Nager.Date Connector provides a RESTful interface to access public holiday and long weekend data for over 100 countries worldwide. This connector allows applications to check if today is a holiday, retrieve holiday dates for a specific country and year, and get upcoming public holidays globally. It is ideal for scheduling platforms, travel apps, workforce planning tools, and calendar integrations.
Integration Overview
The Nager.Date Connector offers the following integration points for retrieving holiday-related data:
Supported Integration Action Points
- Get Public Holidays by Year and Country – Fetch public holidays for a given year and country.
- Check if Today is a Public Holiday – Verify if the current day is a public holiday for a given country.
- Get Next Public Holidays by Country – Retrieve upcoming holidays for a specific country.
- Get Next Public Holidays Worldwide – List the nearest upcoming public holidays across all supported countries.
Detailed Integration Documentation
Get Public Holidays by Year and Country
| Operation ID | getPublicHolidays |
| Endpoint | /PublicHolidays/{year}/{countryCode} |
| Parameters |
|
| Purpose | Returns all public holidays for the specified country and year. |
| Output | JSON array of holiday objects with date, local name, and English name. |
| Workflow Example |
|
Check if Today is a Public Holiday
| Operation ID | isTodayPublicHoliday |
| Endpoint | /IsTodayPublicHoliday/{countryCode} |
| Parameters |
|
| Purpose | Checks if the current date is a public holiday in the given country. |
| Output | Boolean (true or false). |
| Workflow Example |
|
Get Next Public Holidays by Country
| Operation ID | getNextPublicHolidays |
| Endpoint | /NextPublicHolidays/{countryCode} |
| Parameters |
|
| Purpose | Retrieves the upcoming public holidays for the given country from the current date onward. |
| Output | JSON array with holiday details. |
| Workflow Example |
|
Get Next Public Holidays Worldwide
| Operation ID | getNextPublicHolidaysWorldwide |
| Endpoint | /NextPublicHolidaysWorldwide |
| Parameters |
|
| Purpose | Lists the next upcoming public holidays across all supported countries. |
| Output | JSON array with country codes, names, and holiday dates. |
| Workflow Example |
|
Workflow Creation with the Connector
Example Workflow: Holiday-Aware Scheduling Tool
| Select Country and Year | Use getPublicHolidays to retrieve all holiday dates for a country. |
| Check for Today | Call isTodayPublicHoliday to trigger alerts or adjust schedules. |
| Plan Ahead | Use getNextPublicHolidays to prepare for upcoming holidays. |
| Global View | For multi-country operations, call getNextPublicHolidaysWorldwide to monitor global holiday impact. |
Pricing
iSolution logo - white - transparent 250 px