Deutsche Schulferien API

Jetzt loslegen

Bundesländer

Jahre verfügbar

100%

Kostenlos

24/7

Verfügbar

API Dokumentation Beispiel testen

V1 - BEWÄHRT

Klassische API

Die ursprüngliche, bewährte API für alle, die bereits bestehende Integrationen haben.

Einfache Abfragen nach Jahr
Filterung nach Bundesland
100% Abwärtskompatibilität
Bewährt und stabil

GET /api/v1/2026/ GET /api/v1/2026/BY

V2 - ERWEITERT

Erweiterte API

Die neue Generation mit mächtigen Filtermöglichkeiten und zusätzlichen Features.

Erweiterte Filterung (Datum, Typ, Bundesländer)
Aktuelle und kommende Ferien
Suche und Statistiken
Datumsabfragen
Jahresvergleiche
Flexible Feldauswahl
Kalender-Abo (iCal)

GET /api/v2/2026?type=sommerferien&states=BY,BW GET /api/v2/current GET /api/v2/ical/BY.ics

Praktische Beispiele

Hier sind einige häufig verwendete Abfragen:

Aktuelle Ferien abrufen: GET /api/v2/current

Sommerferien für Bayern und Baden-Württemberg: GET /api/v2/2026?type=sommerferien&states=BY,BW

Ist der 25. Juli ein Ferientag? GET /api/v2/date/2026-07-25

Suche nach allen Osterferien: GET /api/v2/search?q=oster

Ferienkalender abonnieren

Alle Ferien Ihres Bundeslands direkt im Kalender, neue Jahre kommen automatisch dazu. In Google Kalender über „Per URL hinzufügen“ z. B. https://schulferien-api.de/api/v2/ical/BY.ics eintragen.

Baden-Württemberg Bayern Berlin Brandenburg Bremen Hamburg Hessen Mecklenburg-Vorpommern Niedersachsen Nordrhein-Westfalen Rheinland-Pfalz Saarland Sachsen Sachsen-Anhalt Schleswig-Holstein Thüringen

Verfügbare Daten

Jahre

2022, 2023, 2024, 2025, 2026, 2027, 2028, 2029

Bundesländer

Alle 16 deutschen Bundesländer (BW, BY, BE, BB, HB, HH, HE, MV, NI, NW, RP, SL, SN, ST, SH, TH)

Ferientypen

Winter-, Oster-/Frühjahrs-, Pfingst-, Sommer-, Herbst-, Weihnachtsferien sowie variable Ferientage (Brandenburg)

System

Gesundheitschecks, Status, Überwachung

Warum diese API?

Kostenlos

Komplett kostenlos, ohne API-Keys oder Registrierung

Schnell

Optimiert für niedrige Latenz mit In-Memory-Caching

Zuverlässig

99.9% Verfügbarkeit mit umfassenden Tests

Dokumentiert

Vollständige interaktive API-Dokumentation

Ressourcen

Alles, was Sie für den Einstieg benötigen:

Swagger UI — Interaktive Dokumentation API Gesundheitsstatus Detaillierter Systemstatus GitHub Repository