festivos.online

API pública de festivos

Consulta los días festivos de Colombia y Chile en formato JSON. Gratis, sin clave de API y con CORS abierto: ideal para apps, bots, hojas de cálculo o integraciones.

Gratis Sin registro JSON estático

Endpoints disponibles

Cada combinación de país y año tiene una URL fija. Países disponibles: colombia (CO), chile (CL). Años disponibles: 2025, 2026, 2027, 2028, 2029. 

GET https://festivos.online/api/colombia/2026.json
GET https://festivos.online/api/chile/2027.json

Ejemplo de respuesta

{
  "pais": "Colombia",
  "codigoISO": "CO",
  "año": 2026,
  "fuenteLegal": "Ley 51 de 1983 (Ley Emiliani) y Ley 2578 de 2026",
  "total": 19,
  "festivos": [
    {
      "fecha": "2026-01-01",
      "nombre": "Año Nuevo",
      "diaSemana": "jueves",
      "categoria": "fijo",
      "trasladado": false
    },
    {
      "fecha": "2026-07-13",
      "nombre": "Virgen del Rosario de Chiquinquirá",
      "diaSemana": "lunes",
      "categoria": "trasladado",
      "trasladado": true
    }
  ]
}

Ejemplo con curl

curl -s https://festivos.online/api/colombia/2026.json

Campos de cada festivo

  • fecha: fecha oficial del descanso en formato ISO (AAAA-MM-DD).
  • nombre: nombre oficial del festivo según la ley.
  • diaSemana: día de la semana del descanso, en español.
  • categoria: fijo, trasladado, religioso o semana-santa.
  • trasladado: true si el descanso se movió al lunes u otra fecha por ley, false si coincide con su fecha original.

Fuentes legales

Los datos provienen de la legislación oficial de cada país: Ley 51 de 1983 (Ley Emiliani) y Ley 2578 de 2026 (Colombia); Ley 2.977 y leyes posteriores (Ley 19.668, 20.148, 20.215, 20.983, 21.357) (Chile). Las fechas religiosas se calculan con el algoritmo gregoriano del Domingo de Pascua.

Preguntas frecuentes

¿La API es gratis?
Sí. La API es completamente gratuita, no requiere clave ni registro, y sirve archivos JSON estáticos generados a partir de la legislación vigente de cada país.
¿Qué años están disponibles?
Actualmente se publican los años 2025, 2026, 2027, 2028, 2029 para Colombia y Chile. Cada año agregamos los nuevos calendarios.
¿Puedo usar la API en producción?
Sí. Al ser archivos estáticos servidos con CORS abierto, puedes consumirlos directamente desde el navegador o tu backend. Agradecemos un enlace a festivos.online como fuente.