NextBreak

Offene Daten

Schulferien für Entwickler

Alle Schulkalender auf NextBreak als JSON, CSV und iCal, kostenlos nutzbar mit Quellenangabe. Für Reiseportale, Schul-Apps, Smart Homes und die Forschung.

JSON- und CSV-API

Kein Schlüssel, keine Anmeldung. Antworten werden einige Stunden zwischengespeichert; bitte bleiben Sie bei etwa zwei Anfragen pro Sekunde.

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}'

Jeder Ferieneintrag enthält den englischen und den lokalen Namen, die Art (autumn, christmas, winter, spring, may, summer, other), den ersten und letzten Tag (end ist null, solange die Behörde ihn noch nicht veröffentlicht hat), das Schuljahr und die offizielle Quelle, anhand derer er geprüft wurde.

Kalender-Feeds (iCal)

Jeder Kalender hat einen Feed, der sich automatisch aktualisiert, wenn eine Behörde einen Termin ändert. Die Adresse finden Sie auf jeder Kalenderseite unter „Alle Ferien zum Kalender hinzufügen“.

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

Home Assistant

Mit einem Kalender-Feed schalten Sie in den Ferien Schultag-Wecker und Heizpläne ab.

  1. Öffnen Sie in Home Assistant Einstellungen → Geräte & Dienste → Integration hinzufügen → Remote Calendar.
  2. Fügen Sie die iCal-Adresse Ihres Kalenders ein (zum Beispiel die für Bayern oben) und geben Sie ihm einen Namen.
  3. Nutzen Sie die neue Kalender-Entität in Automatisierungen: Während der Schulferien ist sie eingeschaltet.
# 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 }

Lizenz

Die Daten stehen unter CC BY 4.0: Nutzen Sie sie in jedem Projekt, auch kommerziell, und nennen Sie „NextBreak (nextbreak.app)“ mit Link als Quelle.

Die Termine stammen von den Schulbehörden; Schulen können einige eigene freie Tage festlegen. Prüfen Sie die Quelle, bevor Sie etwas planen, das sich nicht verschieben lässt.

Quellen und Abdeckung →