Diese API ermöglicht den strukturierten Zugriff auf gesetzliche Feiertage, Gedenktage und festliche Anlässe in Deutschland. Sie ist ideal für Integrationen in Kalender, HR-Software, Schulen oder öffentliche Portale.

Verfügbare Endpunkte

GET /api/year/{year}

Gibt alle Feiertage für ein bestimmtes Jahr zurück.

• Beispiel: https://die-feiertage-in-deutschland.de/api/year/2025
• Parameter: {year} = gewünschtes Jahr (z. B. 2025)
• Antwortformat: JSON (als items[]-Array)

Geplante Endpunkte

• /api/state/{state}/{year} – Feiertage für ein bestimmtes Bundesland
• /api/month/{month}/{year} – Feiertage eines Monats
• /api/search?q=... – Volltextsuche nach Feiertagsnamen

Antwortstruktur

Die API liefert ein JSON-Objekt mit dem Schlüssel items, das ein Array von Feiertagsobjekten enthält. Jedes Objekt enthält folgende Felder:

• holiday_name – Name des Feiertags
• holiday_date – Datum im Format DD.MM.YYYY
• holiday_day – Tag (numerisch)
• holiday_month_number – Monatsnummer (1–12)
• holiday_month_name – Monatsname
• holiday_year – Jahr
• applicable_states – Gültige Bundesländer
• category_code – Technischer Code (z. B. PUBLIC, EVENT)
• category_label – Beschreibungstyp (z. B. Gesetzlicher Feiertag)
• holiday_description – Erklärung oder kultureller Kontext

Beispiel

Aufruf: https://die-feiertage-in-deutschland.de/api/year/2025

{
  "items": [
    {
      "holiday_name": "Neujahr",
      "holiday_date": "01.01.2025",
      "holiday_day": 1,
      "holiday_month_number": 1,
      "holiday_month_name": "Januar",
      "holiday_year": 2025,
      "applicable_states": "Alle Bundesländer",
      "category_code": "PUBLIC",
      "category_label": "Gesetzlicher Feiertag",
      "holiday_description": "Der erste Tag des Jahres markiert den Beginn eines neuen Kalenderjahres. In vielen Kulturen wird dieser Tag als Neuanfang gefeiert."
    }
  ]
}