PApartoo
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}

Request

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"
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.