REST API Dokumentation

API v2.1

Die API v2.1 bietet eine klare Struktur mit dedizierten Endpunkten für jeden Standorttyp. Dies verhindert Mehrdeutigkeiten, wenn mehrere Standorte denselben Slug haben (z.B. "Hessen" als Bundesland und als Stadt).

Alle API-Endpunkte sind öffentlich zugänglich und erfordern keine Authentifizierung. Die Antworten erfolgen im JSON-Format und folgen einem konsistenten Schema.

Dokumentationsseiten

Schnellstart

Beispiel: Schulferien für Bayern im Jahr 2025 abrufen:

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

Antwort:

{
  "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
    }
  ],
  "meta": {
    "api_version": "2.1"
  }
}