API pública
API de solo lectura, sin autenticación, para consultar feriados chilenos desde otras aplicaciones.
Endpoints
- GET
/feriados/api/v1/holidays?year=2026Lista feriados de un año. - GET
/feriados/api/v1/holidays?year=2026&scope=nationalFiltra por alcance: national, regional o communal. - GET
/feriados/api/v1/holidays?year=2026®ion=metropolitanaNacionales más los feriados de la región. - GET
/feriados/api/v1/holidays?year=2026&commune=santiagoNacionales más los feriados aplicables a la comuna. - GET
/feriados/api/v1/holidays/next?limit=4Próximos feriados nacionales. - GET
/feriados/api/v1/holidays/2026-09-18-independencia-nacionalDetalle de un feriado por id. - GET
/feriados/api/v1/locationsRegiones y comunas disponibles. - GET
/feriados/api/v1/metaMetadatos de la API y versión de datos.
Formato de respuesta
{
"data": [],
"meta": {
"apiVersion": "v1",
"generatedAt": "ISO-8601",
"dataVersion": "2026.1",
"source": "Feriado Claro"
}
}Convenciones
- Fechas
- Formato ISO YYYY-MM-DD.
- Errores
- JSON consistente con código HTTP apropiado.
- Caché
- public, s-maxage=3600, stale-while-revalidate=86400.
- Auth
- No requiere autenticación en v1.