Feiertage-API - Deutsche Feiertage als JSON-API

Dokumentation

API-Referenz

Ein einziger Endpoint - flexibel über zwei Parameter steuerbar.

GET /api/v1/feiertage

Parameter

Parameter	Format	Beschreibung
date	`YYYY` `YYYY-MM` `YYYY-MM-DD` optional - Standard: aktuelles Jahr	Bestimmt den Zeitraum der Abfrage. `2026` → ganzes Jahr `2026-04` → ganzer April `2026-04-03` → nur 3. April
bundesland	`BW` `BY` `BE` … optional - Standard: alle Bundesländer	Filtert nach Bundesland. Mehrere Werte mit Bindestrich trennen: `bundesland=BW-BY-SN` Ohne diesen Parameter werden Feiertage für alle 16 Bundesländer ausgegeben.

Response-Format

JSON

{
  "status": "ok",
  "query": {
    "date": "2026-04-03",
    "bundesland": "alle"
  },
  "count": 1,
  "holidays": [
    {
      "date": "2026-04-03",
      "name": "Karfreitag",
      "slug": "karfreitag",
      "type": "easter",
      "nationwide": true,
      "states": [
        { "code": "BW" },
        { "code": "BY" },
        // ... alle 16 Bundesländer
      ]
    }
  ]
}

Felder pro Feiertag

Feld	Typ	Beschreibung
date	`string`	Datum im Format `YYYY-MM-DD`
name	`string`	Deutscher Name des Feiertags
slug	`string`	Maschinenlesbarer Bezeichner
type	`string`	`fixed`, `easter` oder `calculated`
nationwide	`boolean`	`true` wenn bundesweit gültig
states	`array`	Bundesländer mit ggf. Einschränkungen (`note`)
city_exceptions	`array?`	Städte-Sonderfälle (z.B. Augsburg), nur wenn vorhanden

Rate-Limit: Maximal 100 Anfragen pro Stunde und IP-Adresse. Jede Antwort enthält die Header X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset.

Fehler-Responses

400 / 429 / 500

{
  "error": true,
  "message": "Ungültiges Datumsformat.",
  "hint": "Erlaubte Formate: YYYY, YYYY-MM, YYYY-MM-DD"
}

Beispiele

Häufige Abfragen

Alle Feiertage 2026

/api/v1/feiertage?date=2026

Komplettes Jahr, alle Bundesländer

Dezember 2026 in Bayern

/api/v1/feiertage?date=2026-12&bundesland=BY

Ein Monat, ein Bundesland

Ist der 3. Oktober frei?

/api/v1/feiertage?date=2026-10-03

Einzelner Tag prüfen

NRW und Hessen vergleichen

/api/v1/feiertage?date=2026&bundesland=NW-HE

Mehrere Bundesländer kombinieren

Feiertage in Sachsen

/api/v1/feiertage?date=2026&bundesland=SN

Inkl. Buß- und Bettag

Aktuelles Jahr, alle

/api/v1/feiertage

Ohne Parameter → aktuelles Jahr, alle Länder

Integration (JavaScript)

JavaScript

// Feiertage für April 2026 in BW und BY abrufen
const response = await fetch(
  'https://ist-feiertag.de/api/v1/feiertage?date=2026-04&bundesland=BW-BY'
);
const data = await response.json();

data.holidays.forEach(holiday => {
  console.log(`${holiday.date}: ${holiday.name}`);
});

Integration (PHP)

PHP

// Prüfen ob heute ein Feiertag ist
$date = date('Y-m-d');
$url  = "https://ist-feiertag.de/api/v1/feiertage?date={$date}";
$json = file_get_contents($url);
$data = json_decode($json, true);

if ($data['count'] > 0) {
    echo "Heute ist " . $data['holidays'][0]['name'];
}

Ausprobieren

API-Tester

Teste die API direkt im Browser - kein Account, kein API-Key nötig.

Datum

Bundesland

GET /api/v1/feiertage?date=2026

← Klicke „Abfragen" um die API zu testen

Referenz

Bundesland-Codes

Verwende diese Kürzel im Parameter bundesland.

BW Baden-Württemberg

BY Bayern

BE Berlin

BB Brandenburg

HB Bremen

HH Hamburg

HE Hessen

MV Mecklenburg-Vorpommern

NI Niedersachsen

NW Nordrhein-Westfalen

RP Rheinland-Pfalz

SL Saarland

SN Sachsen

ST Sachsen-Anhalt

SH Schleswig-Holstein

TH Thüringen

Sonderfälle

Einige Feiertage gelten nur eingeschränkt innerhalb eines Bundeslandes. Diese Einschränkungen werden im Feld note der jeweiligen State-Zuordnung bzw. im Feld city_exceptions ausgegeben.

Feiertag	Einschränkung
Augsburger Hohes Friedensfest	Nur im Stadtgebiet Augsburg (BY)
Mariä Himmelfahrt	In BY nur in Gemeinden mit überwiegend kath. Bevölkerung
Fronleichnam	In SN und TH nur in Gemeinden mit entsprechender Tradition