API-Dokumentation

Jahresdaten

API: Data/Country/CH

Holt Feiertage und Schulferien für ein ganzes Jahr für alle Gemeinden der Schweiz.

Funktion

Diese API ermittelt für alle **Gemeinden der Schweiz**, an welchen Tagen im Jahr ein offizieller Feiertag oder Schulferien stattfinden. Die Daten enthalten auch die BFS-Gemeindenummer. Erforderliche Parameter ist `api_key`. Der Parameter `year` ist optional – falls er nicht angegeben wird, wird automatisch das aktuelle Jahr verwendet. Zusätzlich kann die Ausgabe über weitere Parameter konfiguriert werden. Die Parameter werden als JSON im Request-Body übergeben. Alternativ kann die Autorisierung auch im Header erfolgen.

Interaktive Anleitung und OpenAPI

OpenAPI 3.0 (Swagger) – Interaktive API-Dokumentation

Öffnet die interaktive API-Dokumentation mit Swagger, in der Sie API-Endpunkte testen und erkunden können.

OpenAPI JSON-Spezifikation herunterladen

API-Kapitel

URL für Anfragen

Zum Abrufen der Daten verwenden Sie folgende URL. Achten Sie bitte auf Gross-Kleinschrift.

POST / GET 
https://feiertagskalender.ch/api/Data/Country/CH/index.php

Parameter für Anfragen

Mit den folgenden Variablen können Sie die Abfrage vervollständigen und die API-Ergebnisse steuern.

Parameter Erläuterung Beispiele
api_key
erforderlich 		Ihr API-Schlüssel api_key=abc-123-def-456
year
oder
jahr

Jahr der gewünschten Daten

ohne Angabe: laufendes Kalenderjahr (= Standard)

 year= 2026
class
oder
klasse

Umfang der Daten

Varianten:
0 = nur Schulferien
3 = 0 + gesetzlich anerkannte Feiertage
4 = 0 + 3 + gesetzliche und gesetzlich nicht anerkannte Feiertage (religiöse, kulturelle) (= Standard)
5 = 0 + 3 + 4 + Ereignistage (z.B. Valentinstag, Muttertag, Advent)

 klasse=5
charset

Die gewünschte Codierung der Antwort

Varianten:
UTF-8 (= Standard)
ISO-8859-1

 charset=iso-8859-1
format

Das gewünschte Ausgabeformat

Varianten:
JSON (= Standard)
XML
CSV

format=xml
date_format

Das gewünschte Datumsformat für die Antwort. Standard:`Y-m-d` (z.B., 2025-12-31)
Das Format entspricht der Datumsformatierung der PHP-Anweisung date()

Varianten:
Y-m-d = YYYY-MM-DD (ISO-8601) (= Standard)
d.m.Y = DD.MM.YYYY
Ymd = YYYYMMDD
dmY = DDMMYYYY
d.m.y = DD.MM.YY
j.n.y = D.M.YY

 date_format=d.m.Y
hl

Gewünschte Sprache der Ausgabe

Varianten:
de = Deutsch (= Standard)
fr = Französisch
it = Italienisch
en = Englisch

hl=en

Beispiele (URL / PHP / Python / JavaScript)

Beispiele anzeigen

Rückgabewerte des API

Die Inhalte der API-Antworten ergeben sich aus:
- den von Ihnen abonnierten Daten (Länder, Feiertage, Schulferien, Kalenderjahre)
- den offiziell bekannten Daten der Gesetzgeber
- der Verfügbarkeit aufgrund unserer Recherchen (IST-Situation unserer Datenbank)

Beachten Sie bitte, dass die Ausgabe im CSV-Format abweicht.

Array         Erläuterung Beispiel
interface         Version des API  
source: href       URL zur Datenquelle (Website)  
  description       Bezeichnung der Datenquelle  
copyright href       URL zum Inhaber des Copyrights (Website)  
  description       Bezeichnung des Copyright-Inhabers  
apiName         Identifikation des API Data/Country/CH
apiStatus description       Bezeichnung des API-Status. Für Varianten, siehe unter Fehlermeldungen active
date         Datum des Datenexports 01.05.2025
request: iso       ISO-Landeskürzel, 2-stellig CH
  year       Jahr der Daten in der Ausgabe 2015
  class       Klasse der Abfrage (betrifft den Umfang der Daten) 4
  charset       Schriftcodierung der Ausgabe utf-8
  format       Datenformat der Ausgabe json
  date_format       Datumformat der Ausgabe d.m.Y
  hl       Sprache der Ausgabe, gemäss Anfrage de
results status description     Status der Ausgabe. Für Varianten, siehe unter Fehlermeldungen ok
  locations location description   Bezeichnung der geografischen Einheit Aardorf
      type   Bezeichnung der Art der geografischen Einheit Gemeinde
      geoId   Geo-ID der geografischen Einheit. 2200
      bfsNr   BFS-Gemeindenummer 4551
      iso   ISO-Landeskürzel, 2-stellig CH
      iso-3166-2   Regionencode nach ISO 3166-2 CH-TG
      note   Besondere Hinweise
      events   Die Kalenderevents  
        description Bezeichnung des Feiertags, oder der Schulferien Neujahr
        id Eindeutige ID des Events.
Feiertage haben jedes Jahr dieselbe ID.
Schulferien haben alle ihre eigenen IDs.		 1
        dateStart Datum Beginn des Events 01.01.2015
        dateEnd Datum Ende des Events 01.01.2015
        class Klasse des Events:

0 = Schulferien
1 = gesetzlich anerkannter Feiertag
2 = Den Sonntagen gleichgestellter Feiertag
3 = halber, gesetzlich anerkannter Feiertag (meist ab Mittag)
4 = gesetzlich nicht anerkannter Feiertag (Geschäfte, Schulen, Verwaltungen meist geschlossen), Bankenfeiertag; im Sinne des Europäischen Übereinkommens über die Berechnung der Fristen wird dieser Tag wie ein gesetzlicher Feiertag behandelt (Art. 5).
5 = Ereignistag
# = nur teilweise gültig		 2
        percent Umfang der betroffenen Einwohner / Schulklassen in Prozent 100
        prov Flag für provisorisch festgelegte Daten

0 = definitiv
1 = provisorisch		 0
        note besondere hinweise  

Beispiele (JSON / XML / CSV)

JSON

URL:
https://www.feiertagskalender.ch/api/Data/Country/CH/index.php?api_key=YOUR_API_KEY&year=2022

Antwort des APIs:

{
    "interface": "fcal API 2.02",
    "source": {
        "href": "https://feiertagskalender.ch",
        "description": "feiertagskalender.ch"
    },
    "copyright": {
        "href": "https://psc.ch",
        "description": "psc Peter Schuetz Informatik-Dienstleistungen, CH Arch"
    },
    "apiName": "Data/Country/CH",
    "apiStatus": {
        "description": "active"
    },
    "date": "2025-02-27",
    "request": {
        "iso": "CH",
        "year": 2022,
        "class": "4",
        "charset": "utf-8",
        "format": "json",
        "date_format": "Y-m-d",
        "hl": "de"
    },
    "results": {
        "status": {
            "description": "ok"
        },
        "locations": [
            {
                "description": "Aadorf",
                "type": "Gemeinde",
                "geoId": "2200",
                "bfsNr": "4551",
                "iso": "CH",
                "iso-3166-2": "CH-TG",
                "note": "",
                "events": [
                    {
                        "description": "Neujahr",
                        "id": "1",
                        "dateStart": "2022-01-01",
                        "dateEnd": "2022-01-01",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Berchtoldstag",
                        "id": "3",
                        "dateStart": "2022-01-02",
                        "dateEnd": "2022-01-02",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Karfreitag",
                        "id": "17",
                        "dateStart": "2022-04-15",
                        "dateEnd": "2022-04-15",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Ostern",
                        "id": "18",
                        "dateStart": "2022-04-17",
                        "dateEnd": "2022-04-17",
                        "class": "4",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Ostermontag",
                        "id": "19",
                        "dateStart": "2022-04-18",
                        "dateEnd": "2022-04-18",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    }
                ]
            },
            {
                "description": "Aarau",
                "type": "Gemeinde",
                "geoId": "3",
                "bfsNr": "4001",
                "iso": "CH",
                "iso-3166-2": "CH-AG",
                "note": "",
                "events": [
                    {
                        "description": "Neujahr",
                        "id": "1",
                        "dateStart": "2022-01-01",
                        "dateEnd": "2022-01-01",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Berchtoldstag",
                        "id": "3",
                        "dateStart": "2022-01-02",
                        "dateEnd": "2022-01-02",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Karfreitag",
                        "id": "17",
                        "dateStart": "2022-04-15",
                        "dateEnd": "2022-04-15",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Ostern",
                        "id": "18",
                        "dateStart": "2022-04-17",
                        "dateEnd": "2022-04-17",
                        "class": "4",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Ostermontag",
                        "id": "19",
                        "dateStart": "2022-04-18",
                        "dateEnd": "2022-04-18",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    }
                ]
            },
            {
                "description": "Aarberg",
                "type": "Gemeinde",
                "geoId": "371",
                "bfsNr": "301",
                "iso": "CH",
                "iso-3166-2": "CH-BE",
                "note": "",
                "events": [
                    {
                        "description": "Neujahr",
                        "id": "1",
                        "dateStart": "2022-01-01",
                        "dateEnd": "2022-01-01",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Berchtoldstag",
                        "id": "3",
                        "dateStart": "2022-01-02",
                        "dateEnd": "2022-01-02",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Karfreitag",
                        "id": "17",
                        "dateStart": "2022-04-15",
                        "dateEnd": "2022-04-15",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Ostern",
                        "id": "18",
                        "dateStart": "2022-04-17",
                        "dateEnd": "2022-04-17",
                        "class": "4",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Ostermontag",
                        "id": "19",
                        "dateStart": "2022-04-18",
                        "dateEnd": "2022-04-18",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    }
                ]
            }
        ]
    }
}

XML

URL:
https://www.feiertagskalender.ch/api/Data/Country/CH/index.php?api_key=YOUR_API_KEY&year=2022&format=xml

Antwort des APIs:

<fcal_api>
<interface>fcal API 2.02</interface>
<source>
<href>https://feiertagskalender.ch</href>
<description>feiertagskalender.ch</description>
</source>
<copyright>
<href>https://psc.ch</href>
<description>psc Peter Schuetz Informatik-Dienstleistungen, CH Bern</description>
</copyright>
<apiStatus>
<description>active</description>
</apiStatus>
<apiName>Data/Country/CH</apiName>
<date>2025-02-27</date>
<request>
<iso>CH</iso>
<year>2022</year>
<class>4</class>
<charset>utf-8</charset>
<format>xml</format>
<date_format>Y-m-d</date_format>
<hl>de</hl>
</request>
<results>
<status>
<description>ok</description>
</status>
<locations>
<location>
<description>Aadorf</description>
<type>Gemeinde</type>
<geoId>2200</geoId>
<bfsNr>4551</bfsNr>
<iso>CH</iso>
<iso-3166-2>CH-TG</iso-3166-2>
<note></note>
<events>
<event>
<description>Neujahr</description>
<id>1</id>
<dateStart>2022-01-01</dateStart>
<dateEnd>2022-01-01</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Berchtoldstag</description>
<id>3</id>
<dateStart>2022-01-02</dateStart>
<dateEnd>2022-01-02</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Karfreitag</description>
<id>17</id>
<dateStart>2022-04-15</dateStart>
<dateEnd>2022-04-15</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Ostern</description>
<id>18</id>
<dateStart>2022-04-17</dateStart>
<dateEnd>2022-04-17</dateEnd>
<class>4</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Ostermontag</description>
<id>19</id>
<dateStart>2022-04-18</dateStart>
<dateEnd>2022-04-18</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
</events>
</location>
<location>
<description>Aarau</description>
<type>Gemeinde</type>
<geoId>3</geoId>
<bfsNr>4001</bfsNr>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<note></note>
<events>
<event>
<description>Neujahr</description>
<id>1</id>
<dateStart>2022-01-01</dateStart>
<dateEnd>2022-01-01</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Berchtoldstag</description>
<id>3</id>
<dateStart>2022-01-02</dateStart>
<dateEnd>2022-01-02</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Karfreitag</description>
<id>17</id>
<dateStart>2022-04-15</dateStart>
<dateEnd>2022-04-15</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Ostern</description>
<id>18</id>
<dateStart>2022-04-17</dateStart>
<dateEnd>2022-04-17</dateEnd>
<class>4</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Ostermontag</description>
<id>19</id>
<dateStart>2022-04-18</dateStart>
<dateEnd>2022-04-18</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
</events>
</location>
<location>
<description>Aarberg</description>
<type>Gemeinde</type>
<geoId>371</geoId>
<bfsNr>301</bfsNr>
<iso>CH</iso>
<iso-3166-2>CH-BE</iso-3166-2>
<note></note>
<events>
<event>
<description>Neujahr</description>
<id>1</id>
<dateStart>2022-01-01</dateStart>
<dateEnd>2022-01-01</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Berchtoldstag</description>
<id>3</id>
<dateStart>2022-01-02</dateStart>
<dateEnd>2022-01-02</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Karfreitag</description>
<id>17</id>
<dateStart>2022-04-15</dateStart>
<dateEnd>2022-04-15</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Ostern</description>
<id>18</id>
<dateStart>2022-04-17</dateStart>
<dateEnd>2022-04-17</dateEnd>
<class>4</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Ostermontag</description>
<id>19</id>
<dateStart>2022-04-18</dateStart>
<dateEnd>2022-04-18</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
</events>
</location>
</locations>
</results>
</fcal_api>

CSV

Aufruf:
https://www.feiertagskalender.ch/api/Data/Country/CH/index.php?api_key=YOUR_API_KEY&year=2022&format=csv

Antwort des APIs:

"location";"geoId";"bfsNr";"iso";"iso_3166_2";"description";"id";"dateStart";"dateEnd";"class";"percent";"prov";"note"
"Aadorf";"2200";"4551";"CH";"CH-TG";"Neujahr";"1";"2022-01-01";"2022-01-01";"2";"100";"0";""
"Aadorf";"2200";"4551";"CH";"CH-TG";"Berchtoldstag";"3";"2022-01-02";"2022-01-02";"2";"100";"0";""
"Aadorf";"2200";"4551";"CH";"CH-TG";"Karfreitag";"17";"2022-04-15";"2022-04-15";"2";"100";"0";""
"Aadorf";"2200";"4551";"CH";"CH-TG";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";""
"Aadorf";"2200";"4551";"CH";"CH-TG";"Ostermontag";"19";"2022-04-18";"2022-04-18";"2";"100";"0";""
"Aarau";"3";"4001";"CH";"CH-AG";"Neujahr";"1";"2022-01-01";"2022-01-01";"2";"100";"0";""
"Aarau";"3";"4001";"CH";"CH-AG";"Berchtoldstag";"3";"2022-01-02";"2022-01-02";"2";"100";"0";""
"Aarau";"3";"4001";"CH";"CH-AG";"Karfreitag";"17";"2022-04-15";"2022-04-15";"2";"100";"0";""
"Aarau";"3";"4001";"CH";"CH-AG";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";""
"Aarau";"3";"4001";"CH";"CH-AG";"Ostermontag";"19";"2022-04-18";"2022-04-18";"2";"100";"0";""
"Aarberg";"371";"301";"CH";"CH-BE";"Neujahr";"1";"2022-01-01";"2022-01-01";"2";"100";"0";""
"Aarberg";"371";"301";"CH";"CH-BE";"Berchtoldstag";"3";"2022-01-02";"2022-01-02";"2";"100";"0";""
"Aarberg";"371";"301";"CH";"CH-BE";"Karfreitag";"17";"2022-04-15";"2022-04-15";"2";"100";"0";""
"Aarberg";"371";"301";"CH";"CH-BE";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";""
"Aarberg";"371";"301";"CH";"CH-BE";"Ostermontag";"19";"2022-04-18";"2022-04-18";"2";"100";"0";""

Fehlermeldungen

Art der Ausgabe Fehlermeldung Erläuterung
results: status:
results: status: description not subscribed Sie haben die gewünschten Daten nicht abonniert.
apiStatus
apiStatus: description invalid usage Die Verwendung dieses API ist für diesen Nutzer nicht freigeschaltet.
apiStatus: description invalid key Ungültiger API-Schlüssel.
apiStatus: description invalid referer Ungültiger Zugriff. Links ab Webseiten (Front-Ends) sind nicht zulässig.
apiStatus: description inactive Das API wurde für noch nicht zur Benutzung freigeschaltet.
apiStatus: description expired Die Nutzungsdauer nach Vertrag ist abgelaufen.
© 2003 - 2025 psc Peter Schütz Informatik Dienstleistungen, CH-Arch