Check International Team Holidays
Look up public holidays across multiple countries to coordinate schedules for distributed teams.
Public Holidays
Holidays for any country
Public holiday data for 100+ countries. Look up all holidays in a year, check if a date is a holiday, or find the next upcoming holiday. Useful for scheduling automation, calendar integrations, and holiday-aware workflows.
List Holidays
Get all public holidays for a country and year. Returns holiday names, dates, types, and whether they are fixed or variable dates. Supports 100+ countries by ISO 3166-1 alpha-2 code.
Returns: List of public holidays with names, dates, types, and fixed/variable status
Parameters
country *stringISO 3166-1 alpha-2 country code (e.g. 'US', 'GB', 'DE')
yearnumberYear to get holidays for (defaults to current year)
Example
US holidays for 2026
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "public-holidays",
"skill": "holidays",
"input": {
"country": "US",
"year": 2026
}
}' \
https://api.toolrouter.com/v1/tools/callCheck Holiday
Check if a specific date is a public holiday in a given country. Returns the holiday details if it is, or confirms it is a regular day.
Returns: Whether the date is a holiday, with holiday details if applicable
Parameters
date *stringDate to check in YYYY-MM-DD format
country *stringISO 3166-1 alpha-2 country code (e.g. 'US', 'GB', 'DE')
Example
Is Dec 25 2026 a holiday in the US?
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "public-holidays",
"skill": "is_holiday",
"input": {
"date": "2026-12-25",
"country": "US"
}
}' \
https://api.toolrouter.com/v1/tools/callNext Holiday
Find the next upcoming public holiday for a country from today or from a specified date. Useful for scheduling and planning around holidays.
Returns: Next upcoming public holiday with date, name, and number of days away
Parameters
country *stringISO 3166-1 alpha-2 country code (e.g. 'US', 'GB', 'DE')
from_datestringStart date in YYYY-MM-DD format (defaults to today)
Example
Next US holiday
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "public-holidays",
"skill": "next_holiday",
"input": {
"country": "US"
}
}' \
https://api.toolrouter.com/v1/tools/callSupported Countries
List all countries supported by the public holidays API with their ISO codes and names.
Returns: List of supported countries with ISO codes and names
Example
List supported countries
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "public-holidays",
"skill": "supported_countries",
"input": {}
}' \
https://api.toolrouter.com/v1/tools/callQuick Start
MCP (Claude Code)
claude mcp add --transport stdio \
--env TOOLROUTER_API_KEY=YOUR_API_KEY \
toolrouter -- npx -y toolrouter-mcpREST API
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{"tool":"public-holidays","skill":"holidays","input":{}}' \
https://api.toolrouter.com/v1/tools/callUse Cases
Plan Content Around Holidays
Build a content calendar that aligns with public holidays to maximize engagement and relevance.
Search Papers by Topic
Find relevant academic papers on any research topic across millions of scholarly publications.
Geocode Addresses to Coordinates
Convert street addresses into precise latitude and longitude coordinates for mapping and spatial analysis.
Workflows
Global Team Coordinator
Coordinate distributed teams across timezones, holidays, and languages with one unified workflow.
Remote Team Standup
Run informed standups with timezone awareness, holiday flags, and weather disruption alerts.
Frequently Asked 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.