Zum Inhalt springen
POST AI agent ready /v1/holidays/list

Feiertags-API – Feiertagsliste nach Land und Jahr

Gibt alle Feiertage für ein bestimmtes Land und Jahr zurück. Zu jedem Feiertag gehören das Datum, der englische Name, der lokale Name und die Art (Öffentlich, Bank, National usw.). Unterstützt über 100 Länder mit ISO 3166-1 Alpha-2-Ländercodes.

Parameters

stringrequired

ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "DE").

number

Year to list holidays for. Defaults to the current year.

Code examples

curl -X POST https://api.botoi.com/v1/holidays/list \
  -H "Content-Type: application/json" \
  -d '{"country":"US","year":2026}'

When to use this API

Schätzung des Liefertermins

Schließen Sie bei der Berechnung der geschätzten Liefertermine für eine E-Commerce-Bestellung gesetzliche Feiertage aus der Zählung der Werktage aus. Rufen Sie die Feiertagsliste für das Zielland ab und überspringen Sie diese Daten in Ihrer Datumsberechnung.

Mitarbeiterplanung und Gehaltsabrechnung

Markieren Sie Feiertage automatisch in Ihrem Planungssystem. Berechnen Sie Urlaubsgeldsätze, verhindern Sie, dass Manager Schichten planen, die sich mit gesetzlichen Feiertagen überschneiden, und erstellen Sie genaue Gehaltsabrechnungsberichte.

Kalenderintegrationen

Füllen Sie Kalender-Apps vorab mit Feiertagen für das Land des Benutzers aus. Zeigen Sie Feiertage neben persönlichen Ereignissen und Arbeitsbesprechungen an, damit Benutzer freie Tage einplanen können, ohne jeden Feiertag manuell hinzufügen zu müssen.

Frequently asked questions

Wie viele Länder werden unterstützt?
Über 100 Länder werden mit ISO 3166-1 Alpha-2-Codes unterstützt. Große Länder wie die USA, GB, DE, FR, JP, BR, IN, AU und CA verfügen alle über eine vollständige Feiertagsabdeckung.
Sind regionale oder staatliche Feiertage inbegriffen?
Die Antwort konzentriert sich auf nationale Feiertage. Regionale oder landesspezifische Feiertage (z. B. Feiertage in US-Bundesstaaten) sind nicht in der Standardliste enthalten.
Was enthält das Typen-Array?
Das Array „types“ klassifiziert jeden Feiertag. Zu den gebräuchlichen Werten gehören „Öffentlich“ (staatlich anerkannter arbeitsfreier Tag), „Bank“ (Bankfeiertag), „National“ (nationaler Feiertag) und „Optional“ (optional oder nur Feiertag). Ein Feiertag kann mehrere Arten haben.
Kann ich Feiertage für vergangene Jahre abfragen?
Ja. Sie können Feiertage für jedes Jahr von 2000 bis 2100 abfragen. Historische Daten sind nützlich, um frühere Lohn- und Gehaltsabrechnungen zu prüfen oder die Anzahl der Geschäftstage in früheren Zeiträumen zu überprüfen.
Was passiert, wenn ich den Jahresparameter weglasse?
Der Endpunkt ist standardmäßig auf das aktuelle Kalenderjahr eingestellt. Wenn Sie für das nächste Jahr Urlaub benötigen (z. B. für die Planung), geben Sie das Jahr explizit an.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.