Documentación API

[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]

[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] Ejemplos
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

El formato de salida deseado

[Varianten:]
JSON (= [Standard])
XML
CSV

format=xml
date_format

El formato de fecha deseado
El formato corresponde al formato de fecha de la instrucción PHP 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

Ejemplos (URL / PHP / Python / JavaScript)

Mostrar ejemplos

[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)

Tenga en cuenta que la salida en formato CSV es diferente.

Array         [Erläuterung] Ejemplo
interface         [Version des API]  
source: href       [URL zur Datenquelle (Website)]  
  description       Nombre de la fuente de datos  
copyright href       [URL zum Inhaber des Copyrights (Website)]  
  description       Designación del titular de los derechos de autor  
apiName         [Identifikation des API] Data/Country/CH
apiStatus description       Designación del estado de la API. [Für Varianten, siehe unter] [Fehlermeldungen] active
date         Fecha de exportación de los datos 29.10.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       Formato de los datos de salida json
  date_format       Formato de la fecha de salida d.m.Y
  hl       [Sprache der Ausgabe, gemäss Anfrage] es
results status description     [Status der Ausgabe]. [Für Varianten, siehe unter] [Fehlermeldungen] ok
  locations location description   Designación de la unidad geográfica Aardorf
      type   Designación del tipo de unidad geográfica [Gemeinde]
      geoId   [Geo-ID der geografischen Einheit.] 2200
      bfsNr   Número de comunidad FSO 4551
      iso   [ISO-Landeskürzel, 2-stellig] CH
      iso-3166-2   [Regionencode nach ISO 3166-2] CH-TG
      note   Notas especiales
      events   [Die Kalenderevents]  
        description Designación del día festivo o de las vacaciones escolares [Neujahr]
        id ID único del evento.
Los días festivos tienen el mismo ID cada año.
Los días festivos escolares tienen cada uno su propio ID.
1
        dateStart Fecha Inicio del acto 01.01.2015
        dateEnd Fecha de finalización del acto 01.01.2015
        class [Klasse des Events:]

0 = [Schulferien]
1 = [gesetzlich anerkannter Feiertag]
2 = Día festivo al igual que el domingo
3 = [halber, gesetzlich anerkannter Feiertag ] (normalmente a partir del mediodía)
4 = [gesetzlich nicht anerkannter Feiertag] (comercios, escuelas, administraciones cerradas en su mayoría), día festivo; a efectos del Convenio Europeo sobre el Cómputo de Plazos, este día se considera festivo (art. 5).
5 = [Ereignistag]
# = parcialmente válido
2
        percent [Umfang der betroffenen Einwohner / Schulklassen in Prozent] 100
        prov [Flag für provisorisch festgelegte Daten]

0 = definitivamente
1 = [provisorisch]
0
        note notas especiales  

Ejemplos (JSON / XML / CSV)

JSON

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

Respuesta de la API:

{
    "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

Respuesta de la API:

<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

Respuesta de la API:

"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]

Tipo de salida [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