API Festivos
API REST gratuita para festivos en el mundo. Sin autenticación. CORS habilitado.
URL Base
https://www.whenoff.comParámetros
country: código ISO 3166-1 alpha-2 (ej. IT, US, GB). year: 2024–2028.
Límite de solicitudes
Sin límite. Por favor sé razonable. Las respuestas se cachean por 24 horas.
Endpoints
GET
/api/holidays?type=countriesListar todos los países disponibles
Respuesta
{
"count": 122,
"countries": [
{ "code": "IT", "name": "Italy" },
{ "code": "US", "name": "United States" },
...
]
}GET
/api/holidays?country={CC}&year={YYYY}Obtener festivos para un país y año
Respuesta
{
"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-weekendsObtener puentes para un país y año
Respuesta
{
"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}Descargar archivo calendario .ics para un país
Respuesta
Returns .ics file (text/calendar)
GET
/api/calendar?country={CC}&year={YYYY}&slug={slug}Descargar .ics para un solo festivo
Respuesta
Returns .ics file (text/calendar)