API JSON pública del Calendario Laboral (v1)

Esta API expone los calendarios laborales de España en formato JSON. Todas las rutas empiezan por /es/v1/{año}/....

Es gratuita, no requiere registro ni clave de acceso y no tiene límites de peticiones. Las respuestas se sirven en formato JSON con codificación UTF-8. Cubre festivos nacionales, autonómicos, provinciales y locales, además del calendario fiscal (AEAT) y los calendarios escolares por comunidad autónoma.

En la web se destacan por defecto estos años: 2025, 2026, 2027. También puedes consultar el listado completo: 2025, 2026, 2027.

Web 2025 Web 2026 Web 2027

Endpoints disponibles

/es/v1/{año}/todo.json — Dataset completo (España + CCAA + provincias + municipios)
/es/v1/{año}/nacionales.json — Festivos nacionales
/es/v1/{año}/comunidades.json — Comunidades autónomas (sin festivos)
/es/v1/{año}/regiones/{ccaa}.json — Festivos de una comunidad
/es/v1/{año}/regiones/{ccaa}/provincias.json — Provincias de una comunidad
/es/v1/{año}/regiones/{ccaa}/provincias/{provincia}/localidades.json — Localidades de una provincia
/es/v1/{año}/localidades/{ccaa}/{provincia}/{municipio}.json — Festivos de un municipio
/es/v1/{año}/fiscal.json — Calendario fiscal completo (AEAT)
/es/v1/{año}/fiscal/{perfil}.json — Fiscal por perfil (personas-fisicas, autonomos, empresas)
/es/v1/{año}/escolar.json — Calendarios escolares por comunidad autónoma
/es/v1/{año}/escolar/{ccaa}.json — Calendario escolar detallado de una CCAA

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. Consulta los términos y condiciones.

Ejemplo de respuesta JSON

Cada festivo en la respuesta incluye los campos que se describen a continuación. Este es un ejemplo de un elemento del array de festivos:

{
  "date": "2026-01-01",
  "name": "Año Nuevo",
  "scope": "nacional",
  "source": "BOE",
  "sourceUrl": "https://www.boe.es/..."
}

Campos de la respuesta

Campo	Tipo	Descripción
`date`	string	Fecha en formato ISO 8601 (YYYY-MM-DD)
`name`	string	Nombre oficial del festivo
`scope`	string	Ámbito: `nacional`, `autonomico`, `provincial` o `local`
`source`	string	Fuente legal (p. ej. BOE, boletín autonómico)
`sourceUrl`	string?	URL de la fuente oficial (puede ser `null`)

Casos de uso

Software de RRHH y nóminas: calcula días laborables y descuenta festivos automáticamente.
Apps de planificación y gestión de proyectos: integra festivos en Gantt, sprints o calendarios de equipo.
Dashboards empresariales: muestra los próximos festivos o puentes en paneles internos.
Automatización con Zapier/Make: lanza flujos condicionados a días laborables.
Aplicaciones móviles: alimenta calendarios nativos con festivos actualizados.

Ejemplos para 2026

/es/v1/2026/todo.json
/es/v1/2026/nacionales.json
/es/v1/2026/comunidades.json
/es/v1/2026/regiones/and.json
/es/v1/2026/regiones/and/provincias.json
/es/v1/2026/regiones/and/provincias/almeria/localidades.json
/es/v1/2026/localidades/and/almeria/abla.json
/es/v1/2026/fiscal.json
/es/v1/2026/fiscal/autonomos.json
/es/v1/2026/escolar.json
/es/v1/2026/escolar/and.json

Uso web equivalente: calendario laboral 2026.

Preguntas frecuentes

¿La API es gratuita?

Sí. La API es completamente gratuita y de acceso público. No requiere pago ni suscripción. Solo se exige atribución con enlace visible según los términos y condiciones.

¿Necesito registrarme?

No. No necesitas crear una cuenta, solicitar una API key ni rellenar ningún formulario. Puedes empezar a consumir los endpoints directamente desde tu aplicación.

¿Con qué frecuencia se actualizan los datos?

Los datos se actualizan cada vez que se publica un nuevo boletín oficial (BOE, boletines autonómicos o bandos municipales). Los festivos nacionales se publican habitualmente en octubre-noviembre del año anterior. Puedes usar la página de festivos para consultar las fuentes.

¿Puedo usar la API en producción?

Sí. La API está diseñada para uso en producción. Al ser archivos estáticos JSON servidos desde CDN, la disponibilidad y el rendimiento son altos. Recomendamos cachear las respuestas en tu aplicación para optimizar el rendimiento.

¿Qué formato devuelve la API?

Todas las respuestas se sirven en formato JSON con codificación UTF-8 y Content-Type application/json. Puedes consumirlas desde cualquier lenguaje de programación o herramienta que soporte peticiones HTTP. También puedes usar la calculadora de días laborables si prefieres una interfaz visual.