API Feriados Venezuela
Feriados 2026 (Public, Bank y Observance), días hábiles y calendario laboral venezolano en JSON.
Cuatro endpoints para cubrir todos los casos: lista completa de feriados por año (incluye Public, Bank y Observance), verificación de un día específico, próximo feriado desde una fecha y cálculo de días hábiles entre dos fechas.
Datos curados con normadata.io — el catálogo de feriados y las utilidades de calendario laboral provienen de normadata.io, la base de datos de referencia para utilities de cumplimiento y normativa LATAM.
Tipos de feriado en Venezuela
La API devuelve más feriados que una lista básica: incluye Public, Bank y Observance. Cada tipo tiene un efecto laboral distinto.
| Tipo | Efecto laboral | Ejemplos | ¿Cuenta en business-days? |
|---|---|---|---|
| Public | Feriado nacional oficial — afecta a toda la actividad laboral | Año Nuevo, Carnaval, Semana Santa, Navidad | Sí — excluido del conteo |
| Bank | Bancos cerrados — otras empresas pueden operar | Día de Reyes, Inmaculada Concepción | No — se cuenta como día hábil |
| Observance | Día observado culturalmente — sin efecto legal obligatorio | Día del Maestro, Día de las Madres | No — se cuenta como día hábil |
Endpoints disponibles
/v1/holidays?year=2026Lista todos los feriados de Venezuela para el año indicado. Incluye Public, Bank y Observance con campos local_name, types, fixed y global.
/v1/holidays/check?date=2026-04-02Verifica si una fecha específica es feriado, sábado, domingo o día hábil normal.
/v1/holidays/next?from=2026-05-10Retorna el próximo feriado a partir de la fecha indicada, con nombre y días restantes.
/v1/business-days?from=2026-05-10&days=10Calcula cuántos días hábiles hay entre dos fechas, excluyendo fines de semana y feriados Public.
Ejemplos de respuesta
GET /v1/holidays?year=2026 — fragmento
{
"year": 2026,
"country": "VE",
"holidays": [
{
"date": "2026-01-01",
"local_name": "Año Nuevo",
"name": "New Year's Day",
"type": "Public",
"types": ["Public"],
"fixed": true,
"global": true
},
{
"date": "2026-01-06",
"local_name": "Día de Reyes",
"name": "Epiphany",
"type": "Bank",
"types": ["Bank"],
"fixed": true,
"global": true
},
{
"date": "2026-02-16",
"local_name": "Lunes de Carnaval",
"name": "Carnival Monday",
"type": "Public",
"types": ["Public"],
"fixed": false,
"global": true
}
]
}local_name = nombre en español. types = array (un feriado puede tener múltiples tipos). fixed = true para fechas fijas, false para móviles (Carnaval, Semana Santa).
GET /holidays/check — respuesta
{
"date": "2026-04-02",
"is_holiday": true,
"holiday_name": "Jueves Santo",
"is_weekend": false,
"is_business_day": false
}GET /holidays/business-days — respuesta
{
"from": "2026-05-10",
"to": "2026-05-31",
"business_days": 15,
"holidays_in_range": ["2026-05-01"],
"weekends_in_range": 8
}El campo holidays_in_range lista solo feriados Public — los únicos que se descuentan del conteo de días hábiles.
Feriados Venezuela 2026
Todos los feriados del año: Public, Bank y Observance. Los móviles varían cada año; la API los calcula automáticamente. Ver calendario completo con fechas exactas →
| Fecha | local_name | type | fixed |
|---|---|---|---|
| 01 Ene | Año Nuevo | Public | true |
| 06 Ene | Día de Reyes | Bank | true |
| 16 Feb | Lunes de Carnaval | Public | false |
| 17 Feb | Martes de Carnaval | Public | false |
| 02 Abr | Jueves Santo | Public | false |
| 03 Abr | Viernes Santo | Public | false |
| 19 Abr | Declaración de Independencia | Public | true |
| 01 May | Día del Trabajador | Public | true |
| 24 Jun | Batalla de Carabobo | Public | true |
| 05 Jul | Día de la Independencia | Public | true |
| 24 Jul | Natalicio de Simón Bolívar | Public | true |
| 12 Oct | Día de la Resistencia Indígena | Public | true |
| 08 Dic | Inmaculada Concepción | Bank | true |
| 24 Dic | Vísperas de Navidad | Public | true |
| 25 Dic | Navidad | Public | true |
| 31 Dic | Vísperas de Año Nuevo | Public | true |
Casos de uso
Nómina
Calcula días trabajados y días de descanso para el cálculo correcto de salario y beneficios.
SLA y soporte
Define tiempos de respuesta en días hábiles y calcula vencimientos automáticamente.
Cron jobs
Programa tareas automáticas solo en días hábiles usando el endpoint business-days.
Logística
Estima fechas de entrega saltando fines de semana y feriados nacionales.
Pagos y cobros
Desplaza vencimientos al siguiente día hábil cuando caen en feriado Public.
Dashboards
Muestra el próximo feriado y los días hábiles restantes en el mes.
Contratos
Calcula plazos contractuales en días hábiles con base legal venezolana.
E-commerce
Muestra estimaciones de entrega realistas en tu tienda online.
Integración: cron job solo en días hábiles
Un patrón común es ejecutar un proceso (generar reportes, enviar recordatorios, procesar pagos) únicamente en días hábiles venezolanos. Con el endpoint /check puedes verificar al inicio del job si debes continuar:
// Node.js — verificar si hoy es día hábil antes de ejecutar el job
const today = new Date().toISOString().slice(0, 10)
const res = await fetch(
`https://api.cotizave.com/v1/holidays/check?date=${today}`,
{ headers: { 'X-API-Key': 'ctz_live_••••••' } }
)
const { is_business_day } = await res.json()
if (!is_business_day) {
console.log('Hoy no es día hábil, saltando job.')
process.exit(0)
}
// Continuar con la lógica del job...¿Necesitas calendarios laborales de otros países LATAM?
Este endpoint cubre Venezuela. Para calendarios de Argentina, Colombia, México, Brasil, Chile, Perú y otros países de la región, visita normadata.io, el proveedor especializado en normativa y datos de referencia para LATAM.
Explorar normadata.io — calendarios LATAM ↗Preguntas frecuentes
¿Qué tipos de feriados devuelve la API?
La API devuelve tres tipos: Public (feriados nacionales oficiales como Año Nuevo, Carnaval y Navidad), Bank (días en que los bancos cierran, como el Día de Reyes o la Inmaculada Concepción) y Observance (días observados como el Día del Maestro o el Día de las Madres). Esto es más completo que una lista básica de feriados Public solamente.
¿Cómo se calculan los feriados móviles (Carnaval y Semana Santa)?
Los feriados móviles se calculan algorítmicamente cada año. Carnaval cae el Lunes y Martes previos al Miércoles de Ceniza. Semana Santa incluye el Jueves y Viernes Santos antes del Domingo de Pascua, calculado según el algoritmo de Computus.
¿El endpoint business-days cuenta solo feriados Public?
Sí. El cálculo de días hábiles excluye sábados, domingos y únicamente los feriados de tipo Public. Los feriados Bank y Observance no afectan el conteo de días hábiles laborales generales.
¿Qué diferencia hay entre Public, Bank y Observance?
Public son feriados nacionales con efecto legal general (se aplican a toda la actividad laboral). Bank son días en que los bancos cierran pero otras empresas pueden operar. Observance son días reconocidos culturalmente pero sin efecto legal obligatorio en el trabajo.
¿La API cubre feriados regionales o estadales?
Por ahora solo cubre feriados de alcance nacional. Los feriados regionales o estadales (como el día del patrono de cada ciudad) no están incluidos en la versión actual.
¿Para qué sirve el endpoint next-holiday?
Dado una fecha base, retorna el siguiente feriado nacional que le sigue. Útil para mostrar al usuario cuántos días hábiles faltan para el próximo feriado o para automatizar cierres anticipados en sistemas de pagos.
¿Con qué frecuencia se actualizan los datos?
Los feriados fijos no cambian. Los móviles se calculan una vez por año. Si el gobierno decreta un feriado extraordinario, intentamos actualizarlo en 24 horas.