Feiertage-API
Kostenlose REST-API für Feiertage weltweit. Keine Authentifizierung erforderlich. CORS aktiviert.
Basis-URL
https://www.whenoff.comParameter
country: ISO 3166-1 Alpha-2-Code (z.B. IT, US, GB). year: 2024–2028.
Ratenbegrenzung
Kein Ratenlimit. Bitte seien Sie vernünftig. Antworten werden für 24 Stunden gecacht.
Endpunkte
GET
/api/holidays?type=countriesAlle verfügbaren Länder auflisten
Antwort
{
"count": 122,
"countries": [
{ "code": "IT", "name": "Italy" },
{ "code": "US", "name": "United States" },
...
]
}GET
/api/holidays?country={CC}&year={YYYY}Feiertage für ein Land und Jahr abrufen
Antwort
{
"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-weekendsBrückentage für ein Land und Jahr abrufen
Antwort
{
"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}.ics-Kalenderdatei für ein Land herunterladen
Antwort
Returns .ics file (text/calendar)
GET
/api/calendar?country={CC}&year={YYYY}&slug={slug}.ics für einen einzelnen Feiertag herunterladen
Antwort
Returns .ics file (text/calendar)