holidays

This endpoint retrieves all bank and public holidays for a specific country and year.

🎗️ The holidays endpoint supports the query parameters in various combinations. Each of these optional parameters can be chained together to filter the results flexibly. See the below combining multiple filters section for more details.

🎗️ The majority of the query parameters accept multiple values in a comma-separated way.

Examples

• Filter out holidays for a specific type (e.g. national):
  ?country=DE&year=2024&type=national

• Filter out holidays for multiple types (e.g. local or religious):
  ?country=DE&year=2024&type=local,religious

• Filter out holidays for a specific religion:
  ?country=BA&year=2024&religion=2

• Filter out holidays for multiple religions:
  ?country=BA&year=2024&religion=1,2

• Filter out holidays for a specific region:
  ?country=BA&year=2024&region=BIH

• Filter out holidays for multiple regions:
  ?country=BA&year=2024&region=BIH,SRP

• Fetch localized holiday names in a specific language:
  ?country=AT&year=2024&lang=de

• Fetch localized holiday names in multiple languages:
  ?country=AT&year=2024&lang=de,en,tr

Combining Multiple Filters

The holidays endpoint supports combining multiple filters to retrieve more complex queries. All the query string parameters that were listed above can be chained together to filter the results flexibly. For example to fetch “local” holidays for “Christianity” in “June” in “BIH” region of Bosnia and Herzegovina as “xml” and in “German” and “Japanese” languages, a query string would be as follows:

?country=BA
&year=2024
&month=6
&type=local
&region=BIH
&religion=2
&response=xml
&lang=de,ja

Holiday Concepts

Most of our customers only focus on government/bank holidays. In order to obtain these, your best option is to filter holidays using either national or local parameter. If any of these is true, it’s very likely that government offices and banks will be closed in a given country.

religious parameter is typically very useful to identify religious holidays, which in some countries, can be specific to certain religious groups. Unless a religious holiday has either national or local attribute also set to true, it will very likely be an optional holiday for certain religious groups, or no holiday at all.

Religion codes