Feiertagskalender — Feiertags-API Online
Gesetzliche, Bank-, regionale, religiöse Feiertage und Gedenktage für 51 Länder (Europa + Golfstaaten) und ihre Regionen, 2020-2035, aus unserer eigenen Feiertags-Regel-Engine. Zu jedem Feiertag wird angegeben, ob er arbeitsfrei ist, ein Bankfeiertag ist oder in die Schulferien fällt, ob ein auf ein Wochenende fallender Feiertag auf einen anderen Tag verschoben wurde, ob sein Datum noch geschätzt ist (islamischer Kalender) und ob an diesem Tag ein Lkw-Fahrverbot gilt und wann. Berücksichtigt die Kriegsrechtsregelung der Ukraine (Feiertage werden aufgeführt, sind aber nicht arbeitsfrei) und Tagesverschiebungen per Erlass (transfers[]). Bis zu 10 Länder pro Aufruf; ein Jahr oder ein beliebiger Zeitraum von bis zu 731 Tagen.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— Kontingentklasse: cheap
| Parameter | Beschreibung |
|---|---|
country | ISO-2-Ländercode oder kommagetrennte Liste mit bis zu 10 Codes (erforderlich), z. B. DE oder DE,PL,UA |
year | YYYY, 2020-2035 (Standard: aktuelles Jahr). Wird ignoriert, wenn from/to angegeben ist |
from | Beginn des Zeitraums YYYY-MM-DD (zusammen mit to; höchstens 731 Tage) |
to | Ende des Zeitraums YYYY-MM-DD |
region | ISO-3166-2-Region, z. B. DE-BY (oder BY bei einem Land): nur landesweite Feiertage und die dieser Region. Weglassen für alle Regionen |
type | Kommagetrennter Filter: PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE oder all. Standard: alles außer BRIDGE |
lang | Kommagetrennte Sprachcodes für name.translations (Standard: alle vorhandenen Sprachen), z. B. en,uk,pl |
q | Suche in Feiertagsnamen (in jeder Sprache), z. B. christmas |
id | Ein Feiertag per ID (andere Filter werden ignoriert) |
school | 1 = zusätzlich Schulferienzeiträume (school_holidays[]) für Länder auflisten, die sie veröffentlichen |
include | impact = business_intelligence zu jedem Feiertag hinzufügen (Pro und höher) |
min_impact | Nur Feiertage mit einem impact_score von mindestens diesem Wert (0-100); impliziert include=impact |
Antwortfelder — innerhalb des data-Objekts im Antwortumschlag. [] steht für eine Liste, data.items[].name ist also das Feld name jedes Elements. Ein Feld ist null, fehlt oder ist eine leere Liste, wenn wir keinen Wert dafür haben — nie ein Platzhalter.
| Feld | Beschreibung |
|---|---|
data.holidays[].id | Stabile Feiertags-ID, z. B. hol_de_christmas_day_2026 — der Wert, den ?id= akzeptiert. Verlegte (observed) Tage enden auf _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=Montag..7=Sonntag), day_name, is_weekend (Wochenende des Landes). |
data.holidays[].name | en, local (in local_lang) und translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL oder REGIONAL, regions_affected (ISO-3166-2-Codes). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (berechnetes Datum nach islamischem Kalender), note (suspended_martial_law, transferred_by_decree oder null). |
data.holidays[].floating_logic | is_floating, rule (Datumsregel in Klartext), shifted_from (ursprüngliches Datum, wenn ein Wochenendfeiertag verschoben wurde). |
data.holidays[].truck_ban | Feiertags-Lkw-Fahrverbot in diesem Land: applies, time_from, time_until (Ortszeit), min_weight_tons, eve_rule {date,time_from,time_until} für ein Verbot am Vortag, scope_note. |
data.holidays[].business_intelligence | Mit include=impact ab dem Tarif Pro: derselbe modellbasierte Schätzblock, den das Impact-Produkt zurückgibt. |
data.transfers[] | Tagesverschiebungen per Erlass im Zeitraum: date, country_code, kind (day_off | working_day), region, note. |
data.school_holidays[] | Mit school=1: id, start_date, end_date, name, location. |
data.count | Anzahl der zurückgegebenen Feiertage; countries und window {from,to} spiegeln die Anfrage wider. |
curl "https://nakordoni.eu/api/v2/data/holiday-calendar/holidays?country=DE&year=2026®ion=DE-BY&lang=en,de" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Aktualisiert