Feiertag API für alle 16 Bundesländer

Warum es diese API gibt

Wir waren auf der Suche nach einer einfachen Möglichkeit, Feiertage in SpikeTime für die Zeiterfassung zu importieren. Leider haben wir keine fertige API und nicht einmal eine fertige CSV- oder Excel-Datei gefunden, die die Feiertage nach deutschen Bundesländern auflistet. So ist die SpikeTime Feiertag API entstanden. Sie enthält die festen Feiertage und auch die beweglichen Feiertage, die sich aus dem Datum des Ostersonntags ergeben.

Endpunkte

Alle Anfragen sind einfache GET-Requests an https://www.spiketime.de/feiertagapi/. Ihr könnt sie direkt im Browser, mit curl oder aus eurer eigenen Software aufrufen.

Für Postman gibt es eine fertige Collection: getpostman.com/collections/16ba518999fbcff4c02c

JSON, XML oder CSV

Standardmäßig antwortet die API mit JSON. Mit dem Header Accept: application/xml bekommt ihr dieselben Daten als XML. Für Tabellenkalkulationen gibt es den CSV-Endpunkt.

[{"Name":"Sachsen",
  "Abkuerzung":"SN"}, …]

<ArrayOfBundesland …>
  <Bundesland>
    <Abkuerzung>SN</Abkuerzung>
    <Name>Sachsen</Name>
  </Bundesland> …

Land;Abkuerzung;Datum;Feiertag;
Sachsen;SN;2026-11-18;Buß und Bettag;

Code-Beispiele

So holt ihr die Feiertage für Sachsen 2026 in eure Anwendung.

Kopieren# JSON
curl https://www.spiketime.de/feiertagapi/feiertage/SN/2026

# XML
curl -H "Accept: application/xml" https://www.spiketime.de/feiertagapi/feiertage/SN/2026

Kopierenconst res = await fetch("https://www.spiketime.de/feiertagapi/feiertage/SN/2026");
const feiertage = await res.json();

for (const f of feiertage) {
  console.log(f.Datum.slice(0, 10), f.Feiertag.Name);
}

Kopierenimport requests

r = requests.get("https://www.spiketime.de/feiertagapi/feiertage/SN/2026", timeout=10)
for f in r.json():
    print(f["Datum"][:10], f["Feiertag"]["Name"])

Kopieren<?php
$json = file_get_contents("https://www.spiketime.de/feiertagapi/feiertage/SN/2026");
foreach (json_decode($json, true) as $f) {
    echo substr($f["Datum"], 0, 10) . " " . $f["Feiertag"]["Name"] . PHP_EOL;
}

Kopierenusing var http = new HttpClient();
var json = await http.GetStringAsync("https://www.spiketime.de/feiertagapi/feiertage/SN/2026");
using var doc = JsonDocument.Parse(json);
foreach (var f in doc.RootElement.EnumerateArray())
    Console.WriteLine($"{f.GetProperty("Datum").GetString()![..10]} {f.GetProperty("Feiertag").GetProperty("Name")}");

Die API sendet keine CORS-Header. Ruft sie deshalb aus eurem Backend auf und nicht direkt per JavaScript aus dem Browser einer fremden Domain.

Alle Feiertage 2026

Das liefert die API für 2026. Wählt ein Bundesland, um nur dessen Feiertage zu sehen. Die Daten wurden am 9. Oktober 2026 abgerufen.

Bundesländer und Kürzel

Diese Kürzel verwendet ihr im Endpunkt /feiertage/{land}/{jahr}.

So werden bewegliche Feiertage berechnet

Die meisten beweglichen Feiertage hängen am Ostersonntag, dem ersten Sonntag nach dem ersten Frühlingsvollmond. Der Buß- und Bettag ist immer der Mittwoch vor dem 23. November.

Häufige Fragen