API de festivos

Los festivos nacionales, autonómicos y locales de los 8.132 municipios de España, en JSON, gratis y sin clave. Cada festivo cita su boletín oficial.

Para qué sirve

La misma información que ves en Localendario, para tu web, tu app o tu programa de nóminas.

De fuentes oficiales. El BOE y los boletines y datos abiertos de cada comunidad, leídos directamente, con la referencia y el enlace de cada festivo.
Antes que nadie. Las fiestas locales del año que viene aparecen en cuanto se publican.
Completa. Incluye el día de cada isla en Canarias, el del Arán y las fiestas de pedanías y barrios (aparte, en localities).
Gratis y sin registro. Ficheros estáticos en la red de Cloudflare: rápidos y con CORS abierto.

Direcciones

Todas cuelgan de https://api.localendario.com/v1/. Los códigos son los del INE.

Dirección	Qué devuelve
`/v1/towns/{ine}.json`	Un municipio, todos los años: festivos nacionales, autonómicos y locales.
`/v1/towns.json`	Los 8.132 municipios con su código, provincia, comunidad y página.
`/v1/{año}/provinces/{cpro}.json`	Todos los municipios de una provincia en un año, en formato compacto.
`/v1/{año}/regions/{ccaa}.json`	Festivos nacionales y autonómicos de una comunidad (códigos ISO, p. ej. `ES-CM`).
`/v1/index.json`	Años disponibles y, por comunidad, de dónde salen sus fiestas locales.

const res = await fetch('https://api.localendario.com/v1/towns/13087.json');
const valdepenas = await res.json();
const fiestas = valdepenas.years['2027'].holidays.filter((h) => h.level === 'local');

Qué trae cada municipio

{
  "ine": "13087",
  "name": "Valdepeñas",
  "province": "13",
  "region": "ES-CM",
  "url": "https://localendario.com/m/13087-valdepenas/",
  "licence": { "name": "CC BY 4.0", "url": "https://creativecommons.org/licenses/by/4.0/deed.es" },
  "attribution": {
    "text": "Datos: Localendario (localendario.com), a partir del BOE y los boletines…",
    "url": "https://localendario.com/m/13087-valdepenas/",
    "html": "Datos: <a href=\"https://localendario.com/m/13087-valdepenas/\">Localendario</a>"
  },
  "years": {
    "2026": {
      "status": "published",
      "holidays": [
        { "date": "2026-01-01", "name": "Año Nuevo", "level": "national",
          "source": { "ref": "BOE-A-2025-21667", "url": "https://www.boe.es/…" } },
        { "date": "2026-09-08", "name": "Fiestas del Vino", "level": "local",
          "source": { "ref": "…", "url": "…" } }
      ],
      "localities": []
    }
  }
}

status: published cuando ya tenemos sus fiestas locales; pending si aún no se han publicado; not-listed si la lista oficial ya salió y el municipio no está (no las comunicó).
level: national, regional o local.
source: el boletín o los datos abiertos de cada festivo, con su enlace.
nameFrom: cuando el boletín no da nombre, el que tuvo ese día otro año.
localities: fiestas que solo son de una pedanía, parroquia o barrio, con su nombre.

Cómo citarnos

Los datos tienen licencia CC BY 4.0: puedes usarlos para lo que quieras, también en productos de pago, si citas la fuente con un enlace.

Cada respuesta trae el texto y el enlace en attribution. Lo más fácil es pegar esto donde muestres los festivos:

<p>Festivos: datos de <a href="https://localendario.com/m/13087-valdepenas/">Localendario</a> (CC BY 4.0).</p>

¿Lo usas en tu web o tu app? Escríbenos a [email protected] y te añadimos a la lista de quién la usa.

Condiciones

Los datos son orientativos: antes de una decisión laboral o legal, comprueba el boletín que se cita en cada festivo.
Se actualiza cada día. Las respuestas se pueden guardar en caché una hora.
Mientras no leamos directamente alguna comunidad, sus fiestas locales vienen de festivos.io (CC BY 4.0) y la atribución lo dice.
Si necesitas garantías de servicio o avisos cuando cambie un festivo para tu empresa, escríbenos.