API pública para Colombia

Calendario laboral colombiano en una API simple.

HOCO API permite consultar festivos nacionales por año, validar fechas festivas y calcular días hábiles excluyendo sábados, domingos y festivos.

Ver Swagger Ver GitHub

Base URL https://api.hocoapi-colombia.workers.dev

18 Festivos nacionales aproximados por año

3 Tipos de cálculo: fijos, trasladables y Semana Santa

4 Endpoints principales listos para consumir

Características

Diseñada para consultar calendario laboral colombiano sin complicaciones.

01

Festivos por año

Consulta el calendario nacional de festivos de Colombia para cualquier año válido.

02

Días hábiles

Calcula rangos laborales reales excluyendo fines de semana y festivos.

03

Semana Santa

Calcula fechas móviles a partir del Domingo de Pascua con algoritmo gregoriano.

04

Ley Emiliani

Mueve al lunes los festivos trasladables cuando la regla aplica.

05

Swagger incluido

Documentación interactiva para probar cada endpoint desde el navegador.

06

Cloudflare Workers

API desplegada en una infraestructura rápida, global y sin tiempos de espera por inactividad.

Endpoints

Prueba HOCO API desde una sola consola interactiva.

Selecciona un endpoint, cambia solo los parámetros permitidos y ejecuta la petición desde una consola centralizada, limpia y fácil de usar.

GET

Estado de la API

Valida que HOCO API esté activa, disponible y lista para responder.

Este endpoint no necesita parámetros.

Request URL

https://api.hocoapi-colombia.workers.dev/api/health

Consola lista

// Selecciona un endpoint y presiona ejecutar para ver la respuesta JSON.

Cálculo interno

HOCO API calcula los festivos sin depender de servicios externos.

La API genera el calendario nacional a partir del año consultado, combinando fechas fijas, traslado al lunes y cálculo de Semana Santa.

01

Festivos fijos

Fechas que no cambian dentro del calendario: Año Nuevo, Día del Trabajo, Independencia, Batalla de Boyacá, Inmaculada Concepción y Navidad.

02

Festivos trasladables al lunes

Aplica la lógica de traslado al lunes siguiente para festivos como Reyes Magos, San José, San Pedro y San Pablo, Día de la Raza, Todos los Santos e Independencia de Cartagena.

03

Festivos relacionados con Semana Santa

Calcula el Domingo de Pascua con algoritmo gregoriano y desde esa fecha deriva Jueves Santo, Viernes Santo, Ascensión, Cuerpo de Cristo y Sagrado Corazón.

Respuesta estándar

Una estructura clara para todos los endpoints.

JSON

{
  "success": true,
  "message": "Días hábiles calculados correctamente.",
  "data": {
    "from": "2026-01-01",
    "to": "2026-06-01",
    "businessDays": 101,
    "calendarDays": 152,
    "holidaysInRange": [
      "2026-01-01",
      "2026-01-12",
      "2026-03-23",
      "2026-04-02",
      "2026-04-03",
      "2026-05-01",
      "2026-05-18"
    ]
  }
}

Lista para probar

Explora HOCO API desde Swagger.

Consulta modelos, respuestas, parámetros y prueba la API directamente desde el navegador.

Abrir documentación