NextBreak

Open data

Schoolvakanties voor ontwikkelaars

Elke schoolkalender op NextBreak als JSON, CSV en iCal, gratis te gebruiken met bronvermelding. Reissites, schoolapps, slimme huizen en onderzoekers zijn welkom.

JSON- en CSV-API

Geen sleutel en geen registratie. Antwoorden worden een paar uur gecachet; houd het alsjeblieft bij ongeveer twee verzoeken per seconde.

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

Elke vakantie heeft een Engelse en een lokale naam, een soort (autumn, christmas, winter, spring, may, summer, other), een eerste en laatste dag (end is null als de instantie die nog niet heeft gepubliceerd), het schooljaar en de officiële bron waarmee de data zijn gecontroleerd.

Agendafeeds (iCal)

Elke kalender heeft een feed die zichzelf bijwerkt als een instantie een datum wijzigt. Het adres staat op elke kalenderpagina onder ‘Alle vakanties toevoegen aan je agenda’.

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

Home Assistant

Gebruik een agendafeed om wekkers voor schooldagen en verwarmingsschema's tijdens de vakanties uit te zetten.

  1. Open in Home Assistant Instellingen → Apparaten & diensten → Integratie toevoegen → Remote calendar.
  2. Plak het iCal-adres van je kalender (bijvoorbeeld dat van Beieren hierboven) en geef de agenda een naam.
  3. Gebruik de nieuwe agenda-entiteit in automatiseringen: die staat aan tijdens een schoolvakantie.
# 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 }

Licentie

De gegevens zijn gepubliceerd onder CC BY 4.0: gebruik ze in elk project, ook commercieel, en vermeld ‘NextBreak (nextbreak.app)’ met een link.

De data komen van onderwijsinstanties; scholen kunnen zelf nog een paar dagen toevoegen. Controleer de bron voordat je iets plant dat niet kan worden verschoven.

Bronnen en dekking →