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 | Code | Religion | | --- | --- | | 1 | Christianity | | 2 | Islam | | 3 | Buddhism | | 4 | Confucianism | | 5 | Hinduism | | 6 | Jainism | | 7 | Judaism | | 8 | Sikhism | | 9 | Yazidism | | 10 | Zoroastrianism | | 11 | Baha-i Faith |