WhenOff

API Jours Fériés

API REST gratuite pour les jours fériés. Sans authentification. CORS activé.

URL de Base

https://www.whenoff.com

Paramètres

country: code ISO 3166-1 alpha-2 (ex. IT, US, GB). year: 2024–2028.

Limitation de débit

Pas de limite. Soyez raisonnables. Les réponses sont en cache pendant 24 heures.

Points de terminaison

GET/api/holidays?type=countries

Lister tous les pays disponibles

Réponse
{
  "count": 122,
  "countries": [
    { "code": "IT", "name": "Italy" },
    { "code": "US", "name": "United States" },
    ...
  ]
}
GET/api/holidays?country={CC}&year={YYYY}

Obtenir les jours fériés pour un pays et une année

Réponse
{
  "country": "IT",
  "year": 2026,
  "count": 11,
  "holidays": [
    {
      "date": "2026-01-01",
      "name": "New Year's Day",
      "localName": "Capodanno",
      "countryCode": "IT",
      "global": true,
      "counties": null,
      "types": ["Public"]
    },
    ...
  ]
}
GET/api/holidays?country={CC}&year={YYYY}&type=long-weekends

Obtenir les ponts pour un pays et une année

Réponse
{
  "country": "IT",
  "year": 2026,
  "count": 5,
  "longWeekends": [
    {
      "startDate": "2026-01-01",
      "endDate": "2026-01-04",
      "dayCount": 4,
      "needBridgeDay": true,
      "bridgeDays": ["2026-01-02"]
    },
    ...
  ]
}
GET/api/calendar?country={CC}&year={YYYY}

Télécharger fichier calendrier .ics pour un pays

Réponse
Returns .ics file (text/calendar)
GET/api/calendar?country={CC}&year={YYYY}&slug={slug}

Télécharger .ics pour un seul jour férié