Ferien & Feiertage API

← Zurück zur API-Übersicht

Die Ferien- und Feiertage-Endpunkte ermöglichen das Abrufen von Schulferien und gesetzlichen Feiertagen für verschiedene Standorte in Deutschland.

Verfügbare Endpunkte

Alle Standorttypen (Bundesländer, Städte, Landkreise, Schulen) bieten einen /periods Endpunkt.

Endpunkt Beschreibung
/api/v2.1/federal-states/:slug/periods Ferien & Feiertage für ein Bundesland
/api/v2.1/cities/:slug/periods Ferien & Feiertage für eine Stadt
/api/v2.1/counties/:slug/periods Ferien & Feiertage für einen Landkreis
/api/v2.1/schools/:slug/periods Ferien & Feiertage für eine Schule

Query-Parameter

Parameter Erforderlich Beschreibung
start_date Nein Startdatum im Format YYYY-MM-DD (Standard: heute)
end_date Nein Enddatum im Format YYYY-MM-DD (Standard: 1 Jahr nach Startdatum)
type Nein vacation (nur Schulferien) oder holiday (nur Feiertage). Standard: beides

Beispiele

Alle Ferien und Feiertage für Bayern in 2025 

GET https://www.mehr-schulferien.de/api/v2.1/federal-states/bayern/periods?start_date=2025-01-01&end_date=2025-12-31

Nur Schulferien für München 

GET https://www.mehr-schulferien.de/api/v2.1/cities/muenchen/periods?type=vacation&start_date=2025-01-01&end_date=2025-12-31

Nur Feiertage für einen Landkreis 

GET https://www.mehr-schulferien.de/api/v2.1/counties/muenchen-landkreis/periods?type=holiday&start_date=2025-01-01&end_date=2025-12-31

Response-Format 

{
  "data": [
    {
      "id": 123,
      "starts_on": "2025-07-28",
      "ends_on": "2025-09-08",
      "name": "Sommerferien",
      "type": "school_vacation",
      "is_school_vacation": true,
      "is_public_holiday": false
    },
    {
      "id": 456,
      "starts_on": "2025-12-25",
      "ends_on": "2025-12-25",
      "name": "1. Weihnachtsfeiertag",
      "type": "public_holiday",
      "is_school_vacation": false,
      "is_public_holiday": true
    }
  ],
  "meta": {
    "api_version": "2.1",
    "location": {
      "id": 2,
      "name": "Bayern",
      "slug": "bayern",
      "type": "federal_state"
    },
    "date_range": {
      "start_date": "2025-01-01",
      "end_date": "2025-12-31"
    }
  }
}

Feld-Beschreibungen

  • id: Eindeutige ID des Zeitraums
  • starts_on: Startdatum (ISO 8601)
  • ends_on: Enddatum (ISO 8601)
  • name: Name des Zeitraums (z.B. "Sommerferien", "Pfingstmontag")
  • type: Typ des Zeitraums ("school_vacation" oder "public_holiday")
  • is_school_vacation: Boolean, ob es sich um Schulferien handelt
  • is_public_holiday: Boolean, ob es sich um einen gesetzlichen Feiertag handelt

Tipp: Die Perioden werden chronologisch sortiert zurückgegeben. Das meta-Objekt enthält zusätzliche Informationen über den Standort und den angefragten Zeitraum.

Siehe auch