4 endpoints match this tag.
/holidays/check
Check whether a specific date is a public holiday in a given country. Returns holiday name and details if the date is a holiday, or confirms it is not. Supports 100+ countries. Ideal for payroll systems that need to account for public holidays, scheduling apps that should block holiday dates, and business tools that adjust deadlines around non-working days.
/holidays/:country_code
Get all public holidays for a specific country in the current year. A convenient shortcut that does not require specifying the year. Returns holiday names, dates, and types. Ideal for quick lookups and dashboard widgets that display this year's remaining holidays for a given country.
/holidays/:country_code/next
Get a list of upcoming public holidays for a specific country, starting from today. Returns holiday names, dates, and types. Perfect for countdown widgets, office planning tools, travel apps that highlight upcoming holidays at a destination, and calendar integrations that need to mark the next few holidays.
/holidays/:country_code/:year
Get all public holidays for a specific country and year. Returns every official holiday with name, date, and type. Useful for building annual calendar views with holidays highlighted, HR systems that calculate working days, and travel planning tools that show the full holiday schedule for a destination country in any year.