NextBreak

Open data

School holidays for developers

Every school calendar on NextBreak as JSON, CSV and iCal, free to use with attribution. Travel sites, school apps, smart homes and researchers welcome.

JSON and CSV API

No key and no sign-up. Responses are cached for a few hours; please keep to about two requests a second.

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

Each break has its English and local name, its kind (autumn, christmas, winter, spring, may, summer, other), first and last day (end is null when the authority has not published it yet), school year, and the official source it was checked against.

Calendar feeds (iCal)

Every calendar has a feed that updates by itself when an authority changes a date. The address is on each calendar page under "Add all breaks to your calendar".

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

Home Assistant

Use a calendar feed to switch off school-day alarms and heating schedules during the holidays.

  1. In Home Assistant, open Settings → Devices & services → Add integration → Remote calendar.
  2. Paste your calendar's iCal address (for example the Bavaria one above) and give it a name.
  3. Use the new calendar entity in automations: it is on during a school break.
# 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 }

Licence

The data is published under CC BY 4.0: use it in any project, commercial too, and credit "NextBreak (nextbreak.app)" with a link.

Dates come from education authorities; schools can add a few days of their own. Check the source before planning anything that cannot move.

Sources and coverage →