Get Personal $2.00 / 1,000 calls

Public holidays by country and year

What this tool does

This tool looks up public holidays for a specific country and year. You provide a two-letter country code and optionally the year. The platform returns a list of the holidays that fall within that country for that year.

Note: The current version of this tool is not connected to live holiday data sources. It always returns an empty list of holidays and a 'False' result, regardless of the country or year you enter. It is currently non-functional for retrieving actual holiday information.

Common uses

  • Planning business schedules or office closures in advance.
  • Checking when banks or government offices are closed.
  • Informing employee leave policies.

Input data

Parameter Required Example Description
country Yes ES Enter the two-letter country code, for example 'ES' for Spain. This field is required. If left empty or invalid, no holidays will be found.
year No 2026 Enter the four-digit year, for example '2026'. This field is optional. If not entered, the current year is used. Non-number entries are ignored.

Output data

Field Description
country The country code you provided, for example 'ES'.
year The year the lookup was performed for, for example 2026.
holidays A list of public holidays. In the current version, this is always an empty list because the live data connection is not active.