NextBreak

Datos abiertos

Vacaciones escolares para desarrolladores

Todos los calendarios escolares de NextBreak en JSON, CSV e iCal, de uso gratuito con atribución. Webs de viajes, apps escolares, hogares inteligentes e investigadores son bienvenidos.

API JSON y CSV

Sin clave y sin registro. Las respuestas se guardan en caché unas horas; por favor, no superes unas dos solicitudes por segundo.

GET https://nextbreak.app/api/v1/calendars              # every calendar (?format=csv)
GET https://nextbreak.app/api/v1/calendars/DE-BY        # one calendar (?year=2026/27, ?format=csv)
GET https://nextbreak.app/api/v1/off?date=2027-02-15    # every calendar off on a date
curl -s https://nextbreak.app/api/v1/calendars/FR-ZC | jq '.breaks[] | {name, start, end}'

Cada periodo de vacaciones incluye su nombre en inglés y en el idioma local, su tipo (autumn, christmas, winter, spring, may, summer, other), el primer y el último día (end es null cuando la autoridad aún no lo ha publicado), el curso escolar y la fuente oficial con la que se comprobó.

Feeds de calendario (iCal)

Cada calendario tiene un feed que se actualiza solo cuando una autoridad cambia una fecha. La dirección está en la página de cada calendario, en «Añadir todas las vacaciones a tu calendario».

https://nextbreak.app/ical/germany-bavaria.ics
https://nextbreak.app/ical/latvia.ics

Home Assistant

Usa un feed de calendario para desactivar las alarmas de los días de colegio y los horarios de calefacción durante las vacaciones.

  1. En Home Assistant, abre Ajustes → Dispositivos y servicios → Añadir integración → Remote Calendar.
  2. Pega la dirección iCal de tu calendario (por ejemplo, la de Baviera que aparece arriba) y ponle un nombre.
  3. Usa la nueva entidad de calendario en tus automatizaciones: está activa durante las vacaciones escolares.
# automations.yaml: no school run on school holidays
- alias: "School morning alarm"
  trigger: { platform: time, at: "06:45:00" }
  condition:
    - condition: state
      entity_id: calendar.school_holidays_bavaria
      state: "off"
  action: { service: script.school_morning }

Licencia

Los datos se publican bajo CC BY 4.0: úsalos en cualquier proyecto, también comercial, y cita «NextBreak (nextbreak.app)» con un enlace.

Las fechas proceden de las autoridades educativas; los colegios pueden añadir algunos días propios. Consulta la fuente antes de planificar algo que no se pueda cambiar.

Fuentes y cobertura →