REST API

Entwickler-API

Kostenlos · Keine Registrierung · JSON-Format

Kalenderwochen

GET /api/v1/kw/heute

Aktuelle Kalenderwoche

{
  "kw": 13,
  "jahr": 2026,
  "start": "2026-03-23",
  "ende": "2026-03-29",
  "gerade": false,
  "iso": "2026-W13"
}
GET /api/v1/kw/{jahr}

Alle Kalenderwochen eines Jahres

GET /api/v1/kw/{jahr}/{woche}

Details zu einer bestimmten Kalenderwoche

GET /api/v1/datum/{YYYY-MM-DD}

Kalenderwoche für ein bestimmtes Datum

Feiertage

GET /api/v1/feiertage/{jahr}?land=DE®ion=BY

Feiertage für ein Jahr (optional: Land und Region)

{ "jahr": 2026, "land": "DE", "region": "BY", "feiertage": [...] }

Schulferien

GET /api/v1/schulferien/{schuljahr}/{region}

Schulferien für ein Schuljahr und Region (z.B. BY, AT_W, CH_ZH)

Nutzungsbedingungen

  • Kostenlos: Die API ist für private und kommerzielle Nutzung kostenlos.
  • Rate Limit: Maximal 100 Anfragen pro Minute pro IP.
  • Caching: Bitte Antworten für mindestens 1 Stunde cachen.
  • Attribution: Ein Link zu kalenderwoche.info ist erwünscht, aber nicht erforderlich.