Public holidays for a country in a given year
Returns all public holidays for a country in a given calendar year, passed through cleanly from upstream.
Supports a default limit of 50 and an optional limit (1-1000).
query Parameters
countryISO-3166 alpha-2 country code (case-insensitive).
yearCalendar year (2000-2100).
limitMax items to return (1-1000, default 50).
Public holidays for a country in a given year › Responses
Array of public holidays.
dateCalendar date of the holiday.
localNameHoliday name in the country's local language.
nameHoliday name in English.
countryCodeISO-3166 alpha-2 country code.
fixedWhether the holiday falls on a fixed calendar date.
globalTrue for nationwide holidays; false for subdivision-only holidays.
countiesISO-3166-2 subdivision codes the holiday applies to, or null when nationwide.
launchYearFirst year the holiday was observed, when known.
typesHoliday type flags (e.g. Public, Bank, Optional).
Public holidays within an inclusive date range
Returns public holidays for a country falling within an inclusive date range. The relevant year(s) are fetched, merged, filtered to from <= date <= to, and sorted ascending. The range may span at most 5 years.
query Parameters
countryISO-3166 alpha-2 country code (case-insensitive).
fromInclusive start date, YYYY-MM-DD.
toInclusive end date, YYYY-MM-DD (must be on or after 'from').
limitMax items to return (1-1000, default 50).
Public holidays within an inclusive date range › Responses
Array of public holidays within the range, sorted ascending.
dateCalendar date of the holiday.
localNameHoliday name in the country's local language.
nameHoliday name in English.
countryCodeISO-3166 alpha-2 country code.
fixedWhether the holiday falls on a fixed calendar date.
globalTrue for nationwide holidays; false for subdivision-only holidays.
countiesISO-3166-2 subdivision codes the holiday applies to, or null when nationwide.
launchYearFirst year the holiday was observed, when known.
typesHoliday type flags (e.g. Public, Bank, Optional).
Upcoming public holidays (next 365 days)
Returns the upcoming public holidays for a country within the next 365 days, passed through cleanly from upstream.
query Parameters
countryISO-3166 alpha-2 country code (case-insensitive).
limitMax items to return (1-1000, default 50).
Upcoming public holidays (next 365 days) › Responses
Array of upcoming public holidays.
dateCalendar date of the holiday.
localNameHoliday name in the country's local language.
nameHoliday name in English.
countryCodeISO-3166 alpha-2 country code.
fixedWhether the holiday falls on a fixed calendar date.
globalTrue for nationwide holidays; false for subdivision-only holidays.
countiesISO-3166-2 subdivision codes the holiday applies to, or null when nationwide.
launchYearFirst year the holiday was observed, when known.
typesHoliday type flags (e.g. Public, Bank, Optional).
Check whether a date is a public holiday
Returns whether a specific date is a public holiday in a country. The holiday field is the full matching upstream record, or null when the date is not a public holiday.
query Parameters
countryISO-3166 alpha-2 country code (case-insensitive).
dateDate to check, YYYY-MM-DD (year within 2000-2100).
Check whether a date is a public holiday › Responses
Holiday-check result.
countryISO-3166 alpha-2 country code that was checked.
dateDate that was checked.
is_holidayWhether the date is a public holiday.
The matching holiday record, or null when the date is not a public holiday.