¿Puedo usar la API para integrarla en mi aplicación?

Sí, puedes consumir los endpoints desde cualquier aplicación web, móvil o de escritorio. Se requiere atribución visible. No se permite scraping masivo ni sincronizaciones abusivas.

API JSON pública del Calendario Laboral — Colombia (v1)

Q: ¿Qué datos incluye cada festivo en la respuesta JSON?

Cada festivo incluye date (fecha ISO 8601), name (nombre), type (tipo: national, regional o local) y scope (nivel territorial). Las respuestas también incluyen metadatos como year, generatedAt y disclaimer.

Esta API expone los calendarios laborales de Colombia en formato JSON estático, sin necesidad de autenticación. Los festivos se generan algorítmicamente a partir de la Ley 51 de 1983 (Ley Emiliani), lo que garantiza datos correctos para cualquier año sin depender de publicaciones externas. Además incluye endpoints de calendario fiscal (DIAN) y escolar (MEN).

Todas las rutas empiezan por /co/v1/{año}/.... Años disponibles: 2025, 2026, 2027. Listado completo: 2025, 2026, 2027.

Web 2025 Web 2026 Web 2027

Endpoints disponibles

/co/v1/{año}/nacionales.json — Festivos nacionales
/co/v1/{año}/departamentos.json — Departamentos (listado)
/co/v1/{año}/departamentos/{departamento}.json — Festivos de un departamento
/co/v1/{año}/departamentos/{departamento}/{municipio}.json — Festivos de un municipio
/co/v1/{año}/fiscal.json — Calendario fiscal DIAN completo
/co/v1/{año}/fiscal/{perfil}.json — Fiscal por perfil (personas-naturales, personas-juridicas, grandes-contribuyentes)
/co/v1/{año}/escolar.json — Calendarios escolares por departamento
/co/v1/{año}/escolar/{departamento}.json — Calendario escolar detallado de un departamento

Todas las respuestas incluyen calendarType para identificar si el calendario es laboral, fiscal o escolar, y un campo disclaimer indicando que esta API no sustituye a fuentes oficiales.

El uso de la API exige atribución con enlace visible y no permite abuso de sincronizaciones.

Ejemplo de respuesta JSON

Al consultar /co/v1/2026/nacionales.json se obtiene un objeto con la siguiente estructura:

{
  "year": 2026,
  "calendarType": "laboral",
  "country": "CO",
  "holidays": [
    {
      "date": "2026-01-01",
      "name": "Año Nuevo",
      "type": "national",
      "scope": "national"
    },
    ...
  ],
  "stats": {
    "totalHolidays": 18,
    "nationalHolidays": 18
  },
  "generatedAt": "...",
  "disclaimer": "..."
}

Campos de cada festivo

Campo	Tipo	Descripción
`date`	`string`	Fecha en formato ISO 8601 (`YYYY-MM-DD`).
`name`	`string`	Nombre oficial del festivo.
`type`	`string`	Tipo: `national`, `regional` o `local`.
`scope`	`string`	Nivel territorial de aplicación (`national`, `departmental`, `municipal`).

Las respuestas de nivel superior incluyen además year, calendarType, country, stats, generatedAt y disclaimer.

Casos de uso

Nómina y RRHH: integra los festivos nacionales en tu sistema de gestión de nómina para calcular días laborables y recargos dominicales/festivos automáticamente.
Plazos judiciales: combina los festivos con el criterio de días hábiles (CGP art. 118) para computar términos procesales sin errores.
Vencimientos DIAN: consume el endpoint fiscal para mostrar alertas de vencimiento tributario por perfil de contribuyente.
Apps de calendario: sincroniza los festivos colombianos con Google Calendar, Outlook u otras aplicaciones vía los endpoints JSON.
Planificación de proyectos: alimenta herramientas de gestión (Jira, Asana, Monday) con los días no laborables para estimar entregas con mayor precisión.

También puedes usar la calculadora de días laborables para obtener el cómputo directamente en la web.

Ejemplos para 2026

/co/v1/2026/nacionales.json
/co/v1/2026/departamentos.json
/co/v1/2026/departamentos/amazonas.json
/co/v1/2026/departamentos/amazonas/leticia.json
/co/v1/2026/fiscal.json
/co/v1/2026/fiscal/personas-naturales.json
/co/v1/2026/escolar.json
/co/v1/2026/escolar/antioquia.json

Uso web equivalente: festivos Colombia 2026 | calculadora 2026.

Preguntas frecuentes

¿La API es gratuita?

Sí, la API es pública y gratuita. Solo se requiere atribución con enlace visible al sitio y un uso razonable (sin sincronizaciones masivas cada pocos segundos).

¿Qué datos incluye cada festivo en la respuesta JSON?

Cada festivo incluye date (fecha ISO 8601), name (nombre oficial), type (national, regional, local) y scope (nivel territorial). Las respuestas también incluyen metadatos como year, generatedAt y disclaimer.

¿Con qué frecuencia se actualizan los datos?

Los festivos de Colombia se generan algorítmicamente a partir de la Ley 51 de 1983 y son correctos para cualquier año sin depender de publicaciones externas. Los datos fiscales (DIAN) y escolares (MEN) se actualizan cuando las entidades publican nuevas fechas.

¿Puedo usar la API en mi aplicación?

Sí, puedes consumir los endpoints desde cualquier aplicación web, móvil o de escritorio. Las respuestas son JSON estático con cabeceras CORS permisivas. Se requiere atribución visible y no se permite scraping masivo.

¿La API incluye festivos departamentales?

En Colombia los 18 festivos de la Ley 51/1983 son nacionales y aplican en todo el territorio. No existen festivos departamentales oficiales distintos. Los endpoints por departamento y municipio devuelven los mismos festivos nacionales para facilitar la integración por división territorial.