HolidayDB
API de festivos
Datos globales de festivos públicos y vacaciones para sistemas de RR. HH., nómina y cumplimiento normativo.
Datos precisos y actualizados sobre días festivos y vacaciones nacionales y regionales entregados a través de una API simple. Deje de codificar calendarios. Deje de mantener la lógica de vacaciones y días festivos manualmente.
Ejemplo de solicitud
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.holidaydb.com/api/holidays?country=US"Ejemplo de respuesta
[
{
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"country_code": "US",
"religion_slug": null,
"type": "public_holiday",
"scope": "national",
"region_codes": [],
"region_names": [],
"start_date": "2026-07-04",
"end_date": "2026-07-04",
"provisional": false,
"substitute": false,
"summary": "Independence Day",
"language": "en"
}
// ... más objetos de festivo en la respuesta completa (ver /es/documentacion#get-holidays)
]Creado para sistemas exigentes
HolidayDB está diseñado para:
Plataformas de gestión de RR. HH.
Mantenga los registros de empleados y las reglas de permisos sincronizados con los festivos oficiales y las fechas de vacaciones.
Software de nóminas
Calcule correctamente el pago de festivos y vacaciones y las horas extra con fechas precisas.
Sistemas de gestión de permisos
Valide las solicitudes de permiso frente a festivos públicos, fechas de vacaciones y reglas regionales.
Herramientas de control horario
Marque automáticamente festivos y días de vacaciones para que los partes sean conformes.
Sistemas ERP
Impulse flujos de trabajo y aprobaciones desde una única fuente fiable de festivos.
Productos SaaS que se expanden internacionalmente
Añada nuevos países sin mantener la lógica de festivos y vacaciones mercado por mercado.
Cuando los festivos y las vacaciones afectan a la nómina, los saldos de permisos o el cumplimiento, la precisión no es negociable.
Lo que obtienes
Festivos públicos nacionales
Calendarios regionales para 231 países. Fechas de alcance nacional para cada uno.
Festivos por subdivisión
Estados, provincias y regiones: 4788 subdivisiones ISO 3166-2 en CountriesDB para 195 de 231 países con festivos.
Calendarios religiosos
Cristiano, islámico, judío, hindú, cristianismo ortodoxo. religion_slug estable para filtrar.
Soporte multilingüe
Nombres de festivos en el idioma que necesite (plan Full).
Actualizado a diario
Incluye fechas que aún pueden cambiar, para que se mantenga preciso.
API REST limpia
Endpoints simples, respuestas JSON, filtros por país, religión y fecha.
Estructura de datos fiable
Campos y tipos consistentes para una integración sencilla.
Plan gratuito (predeterminado)
Pruebe la integración antes de pasar a producción, sin coste extra.
¿Por qué no usar una lista estática de festivos o vacaciones?
Los datos de festivos y vacaciones copiados o codificados a mano crean riesgos ocultos:
- Las fechas de festivos y vacaciones cambian y se actualizan a diario
- Los festivos por subdivisión varían según la región
- Las fechas observadas se desplazan; algunas aún pueden cambiar
- El mantenimiento se vuelve manual y propenso a errores
- Los errores de nómina son costosos
HolidayDB elimina ese riesgo.
Ejemplos de solicitudes a la API
Devuelve todos los festivos públicos de un país. La respuesta incluye uuid, fechas, type, scope, summary, region_names y language.
Parámetros
countryConsulta: código de país de dos letras (ISO 3166-1 alpha-2), p. ej. US, DE.AuthorizationEncabezado: Bearer YOUR_API_KEY (obligatorio en todas las solicitudes).
GET /api/holidays?country=US
Authorization: Bearer YOUR_API_KEY
[
{
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"country_code": "US",
"religion_slug": null,
"type": "public_holiday",
"scope": "national",
"region_codes": [],
"region_names": [],
"start_date": "2026-07-04",
"end_date": "2026-07-04",
"provisional": false,
"substitute": false,
"summary": "Independence Day",
"language": "en"
}
]Planes de producción
Todos los planes incluyen: acceso a la API, autenticación segura, endpoints versionados, documentación y soporte por correo electrónico.
Gratis
Planes de pago
Basic
Pro
Full
Diseñado para el crecimiento internacional
¿Se expande a nuevos países? HolidayDB le ayuda a:
- Entrar en nuevos mercados más rápido
- Evitar errores de cumplimiento
- Reducir la carga de ingeniería
- Mantener consistente la lógica de festivos y vacaciones entre regiones
Preguntas frecuentes
- ¿Con qué frecuencia se actualizan los datos?
- Los datos se comprueban y se actualizan a diario, incluidas fechas que aún pueden cambiar, para que siempre tenga la información más reciente de festivos y vacaciones.
- ¿Ofrecen festivos por subdivisión?
- Sí. Los festivos por subdivisión cubren estados, provincias y regiones: 4.788 subdivisiones ISO 3166-2 en 231 países con festivos.
- ¿Puedo usar HolidayDB en sistemas de nómina?
- Sí. HolidayDB está diseñada específicamente para integraciones de RR. HH. y nómina.
- ¿Hay una prueba gratuita?
- Sí. Todas las cuentas comienzan en el plan Free, para que pueda probar la integración antes de actualizar para uso en producción.