Holidays
Get holidays
This endpoint allows you to retrieve a list of upcoming bank holidays for a specified country within the next 365 days. The holidays are ordered based on their occurrence dates.
get/holidays/{country}
Path parameters
countrystring required
Country code from ISO 3166 international standard - https://www.iban.com/country-codes
Query parameters
lang'fr' | 'en' | 'es' | 'it' | 'pt-br' | 'de' | 'ar'
Preferred language for holiday names. If no language is provided, the user's default language will be used. If the user's default language is unavailable, the country's primary language will be used.
Example:fr
Response
OK
Example response
{
"holidays": [
{
"name": "Armistice",
"date": "2023-11-11"
},
{
"name": "Noël",
"date": "2023-12-25"
},
{
"name": "Jour de l'an",
"date": "2024-01-01"
},
{
"name": "Lundi de Pâques",
"date": "2024-04-01"
},
{
"name": "Fête du Travail",
"date": "2024-05-01"
},
{
"name": "Fête de la Victoire",
"date": "2024-05-08"
},
{
"name": "Ascension",
"date": "2024-05-09"
},
{
"name": "Lundi de Pentecôte",
"date": "2024-05-20"
},
{
"name": "Fête nationale",
"date": "2024-07-14"
},
{
"name": "Assomption",
"date": "2024-08-15"
},
{
"name": "Toussaint",
"date": "2024-11-01"
},
{
"name": "Christmas",
"date": "2024-12-25"
},
{
"name": "New Year's Day",
"date": "2025-01-01"
}
]
}