API-Dokumentation

Jahresdaten

Jahresdaten für mehrere Orte auslesen

Land und Regionen mittels ISO-Länderkürzel Alle Gemeinden Schweiz, inkl. BFS-Nummern

Alle Postleitzahlen Schweiz, inkl. BFS-Nummern

Alle Gemeinden für 1 Schweizer Kanton

Alle Gemeinden Liechtenstein, inkl. BFS-Nummern

Alle Postleitzahlen Liechtenstein, inkl. BFS-Nummern

Alle Gemeinden Schweden, inkl. SCB-Code

API: Data/Country

Holt Feiertage und Schulferien für ein ganzes Jahr für alle verfügbaren Einträge eines Landes, basierend auf einem ISO-Länderkürzel (iso).

Funktion

Diese API ermittelt für alle erfassten geografischen Einheiten eines Landes, an welchen Tagen im Jahr ein offizieller Feiertag oder Schulferien stattfinden. Erforderliche Parameter sind `api_key` und `iso`. 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
Parameter für Anfragen
Beispiele (URL / PHP / Python / JavaScript)
Rückgabewerte des API
Beispiele (JSON / XML / CSV)
Fehlermeldungen

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/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
iso erforderlich	ISO-Landeskürzel, 2-stellig	iso=DE
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
all_entities	Umfang der Daten 0 = nur Ebenen Land und ISO-3166-2 (= Standard) 1 = alle erfassten Einheiten	&all_entities=1
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

Parameter in der URL

So können Parameter in der URL mitgegeben werden (z.B. über den Browser, oder in Excel):
Hinweis: Der erste Parameter wird mit ? eingeleitet, alle weiteren Parameter werden mit & getrennt.

Wichtig: Dieser Code darf nicht direkt in einer Webseite verwendet werden! API-Schlüssel müssen aus Sicherheitsgründen nur im Backend verarbeitet werden.

https://feiertagskalender.ch/api/Data/Country/index.php?api_key=YOUR_API_KEY&iso=FR&year=2022

Beispiel PHP mit cURL (GET)

$api_url = "https://feiertagskalender.ch/api/Data/Country/index.php?iso=FR&year=2022";
$api_key = "YOUR_API_KEY";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
   "Authorization: Bearer $api_key",
   "Content-Type: application/json"
]);
$response = curl_exec($ch);
curl_close($ch);

echo $response;

Beispiel PHP mit cURL (POST)

$api_url = "https://feiertagskalender.ch/api/Data/Country/index.php";
$api_key = "YOUR_API_KEY";

// POST-Daten
$post_data = json_encode([
    "iso": "FR", "year": "2022"	
]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer $api_key",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Beispiel Python mit requests (GET)

import requests

api_key = "YOUR_API_KEY"
api_url = "https://feiertagskalender.ch/api/Data/Country/index.php?iso=FR&year=2022"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

response = requests.get(api_url, headers=headers)

if response.status_code == 200:
    print(response.json())  # JSON
else:
    print(f"Error: {response.status_code}", response.text)

Beispiel Python mit requests (POST)

import requests

api_key = "YOUR_API_KEY"
api_url = "https://feiertagskalender.ch/api/Data/Country/index.php"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

payload = {
    "iso": "FR", "year": "2022"	
}

response = requests.post(api_url, headers=headers, json=payload)

if response.status_code == 200:
    print(response.json())  # JSON
else:
    print(f"Error: {response.status_code}", response.text)

Beispiel JavaScript mit Fetch API (GET)

Die Fetch API ist eine moderne Methode, um HTTP-Anfragen in JavaScript durchzuführen. Sie wird in aktuellen Browsern unterstützt.

Wichtig: Dieser Code darf nicht direkt in einer Webseite verwendet werden! API-Schlüssel müssen aus Sicherheitsgründen nur im Backend verarbeitet werden.

const apiUrl = "https://feiertagskalender.ch/api/Data/Country/index.php?iso=FR&year=2022";
const apiKey = "YOUR_API_KEY";  								
const headers = new Headers({
    "Authorization": "Bearer " + apiKey,
    "Content-Type": "application/json"
});

fetch(apiUrl, { method: "GET", headers })
    .then(response => {
        if (!response.ok) {
            throw new Error(`Error: ${response.status} ${response.statusText}`);
        }
        return response.json();
    })
    .then(data => console.log(data))
    .catch(error => console.error("Error:", error));

Beispiel JavaScript mit Fetch API (POST)

Die Fetch API ist eine moderne Methode, um HTTP-Anfragen in JavaScript durchzuführen. Sie wird in aktuellen Browsern unterstützt.

const apiUrl = "https://feiertagskalender.ch/api/Data/Country/index.php";
const apiKey = "YOUR_API_KEY";  
const requestData = {
    "iso": "FR", "year": "2022"	
};

fetch(apiUrl, {
    method: "POST",
    headers: {
        "Authorization": "Bearer " + apiKey,
        "Content-Type": "application/json"
    },
    body: JSON.stringify(requestData)
})
.then(response => {
    if (!response.ok) {
        throw new Error(`Error: ${response.status} ${response.statusText}`);
    }
    return response.json();
})
.then(data => console.log(data))
.catch(error => console.error("Error:", error));

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
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	DE
	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	Baden-Württemberg
			type		Bezeichnung der Art der geografischen Einheit	Bundesland
			geoId		Geo-ID der geografischen Einheit.	3060
			iso		ISO-Landeskürzel, 2-stellig	DE
			iso-3166-2		Regionencode nach ISO 3166-2	DE-BW
			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/index.php?api_key=YOUR_API_KEY&iso=FR&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",
    "apiStatus": {
        "description": "active"
    },
    "date": "2025-02-27",
    "request": {
        "iso": "FR",
        "year": 2022,
        "class": "4",
        "charset": "utf-8",
        "format": "json",
        "date_format": "Y-m-d",
        "all_entities": 0,
        "hl": "de"
    },
    "results": {
        "status": {
            "description": "ok"
        },
        "locations": [
            {
                "description": "Auvergne-Rhône-Alpes",
                "type": "Region",
                "geoId": "3099",
                "parentId": "3079",
                "iso": "FR",
                "iso-3166-2": "FR-ARA",
                "note": "",
                "events": [
                    {
                        "description": "Neujahr",
                        "id": "1",
                        "dateStart": "2022-01-01",
                        "dateEnd": "2022-01-01",
                        "class": "1",
                        "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": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Tag der Arbeit",
                        "id": "22",
                        "dateStart": "2022-05-01",
                        "dateEnd": "2022-05-01",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Tag des Sieges 1945",
                        "id": "97",
                        "dateStart": "2022-05-08",
                        "dateEnd": "2022-05-08",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Christi Himmelfahrt",
                        "id": "31",
                        "dateStart": "2022-05-26",
                        "dateEnd": "2022-05-26",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Pfingsten",
                        "id": "30",
                        "dateStart": "2022-06-05",
                        "dateEnd": "2022-06-05",
                        "class": "4",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Pfingstmontag",
                        "id": "35",
                        "dateStart": "2022-06-06",
                        "dateEnd": "2022-06-06",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Nationalfeiertag Frankreich",
                        "id": "96",
                        "dateStart": "2022-07-14",
                        "dateEnd": "2022-07-14",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Mariä Himmelfahrt",
                        "id": "42",
                        "dateStart": "2022-08-15",
                        "dateEnd": "2022-08-15",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Allerheiligen",
                        "id": "47",
                        "dateStart": "2022-11-01",
                        "dateEnd": "2022-11-01",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Gedenktag 1918",
                        "id": "98",
                        "dateStart": "2022-11-11",
                        "dateEnd": "2022-11-11",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Weihnachten",
                        "id": "23",
                        "dateStart": "2022-12-25",
                        "dateEnd": "2022-12-25",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Weihnachtsferien",
                        "id": "812135",
                        "dateStart": "2021-12-19",
                        "dateEnd": "2022-01-02",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Winterferien",
                        "id": "812136",
                        "dateStart": "2022-02-13",
                        "dateEnd": "2022-02-27",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Frühlingsferien",
                        "id": "812137",
                        "dateStart": "2022-04-17",
                        "dateEnd": "2022-05-01",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Auffahrtsferien",
                        "id": "812138",
                        "dateStart": "2022-05-26",
                        "dateEnd": "2022-05-26",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Sommerferien",
                        "id": "812139",
                        "dateStart": "2022-07-07",
                        "dateEnd": "2022-08-31",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Herbstferien",
                        "id": "826980",
                        "dateStart": "2022-10-22",
                        "dateEnd": "2022-11-06",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Weihnachtsferien",
                        "id": "826981",
                        "dateStart": "2022-12-17",
                        "dateEnd": "2023-01-02",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    }
                ]
            },
            {
                "description": "Bourgogne-Franche-Comté",
                "type": "Region",
                "geoId": "3101",
                "parentId": "3079",
                "iso": "FR",
                "iso-3166-2": "FR-BFC",
                "note": "",
                "events": [
                    {
                        "description": "Neujahr",
                        "id": "1",
                        "dateStart": "2022-01-01",
                        "dateEnd": "2022-01-01",
                        "class": "1",
                        "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": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Tag der Arbeit",
                        "id": "22",
                        "dateStart": "2022-05-01",
                        "dateEnd": "2022-05-01",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Tag des Sieges 1945",
                        "id": "97",
                        "dateStart": "2022-05-08",
                        "dateEnd": "2022-05-08",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Christi Himmelfahrt",
                        "id": "31",
                        "dateStart": "2022-05-26",
                        "dateEnd": "2022-05-26",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Pfingsten",
                        "id": "30",
                        "dateStart": "2022-06-05",
                        "dateEnd": "2022-06-05",
                        "class": "4",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Pfingstmontag",
                        "id": "35",
                        "dateStart": "2022-06-06",
                        "dateEnd": "2022-06-06",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Nationalfeiertag Frankreich",
                        "id": "96",
                        "dateStart": "2022-07-14",
                        "dateEnd": "2022-07-14",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Mariä Himmelfahrt",
                        "id": "42",
                        "dateStart": "2022-08-15",
                        "dateEnd": "2022-08-15",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Allerheiligen",
                        "id": "47",
                        "dateStart": "2022-11-01",
                        "dateEnd": "2022-11-01",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Gedenktag 1918",
                        "id": "98",
                        "dateStart": "2022-11-11",
                        "dateEnd": "2022-11-11",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Weihnachten",
                        "id": "23",
                        "dateStart": "2022-12-25",
                        "dateEnd": "2022-12-25",
                        "class": "1",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Weihnachtsferien",
                        "id": "812232",
                        "dateStart": "2021-12-19",
                        "dateEnd": "2022-01-02",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Winterferien",
                        "id": "812233",
                        "dateStart": "2022-02-13",
                        "dateEnd": "2022-02-27",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Frühlingsferien",
                        "id": "812234",
                        "dateStart": "2022-04-17",
                        "dateEnd": "2022-05-01",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Auffahrtsferien",
                        "id": "812236",
                        "dateStart": "2022-05-26",
                        "dateEnd": "2022-05-26",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Sommerferien",
                        "id": "812235",
                        "dateStart": "2022-07-07",
                        "dateEnd": "2022-08-31",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Herbstferien",
                        "id": "827049",
                        "dateStart": "2022-10-22",
                        "dateEnd": "2022-11-06",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Weihnachtsferien",
                        "id": "827050",
                        "dateStart": "2022-12-17",
                        "dateEnd": "2023-01-02",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    }
                ]
            }
        ]
    }
}

XML

URL:
https://www.feiertagskalender.ch/api/Data/Country/index.php?api_key=YOUR_API_KEY&iso=FR&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</apiName>
	<date>2025-02-27</date>
	<request>
		<iso>FR</iso>
		<year>2022</year>
		<class>4</class>
		<charset>utf-8</charset>
		<format>xml</format>
		<date_format>Y-m-d</date_format>
		<all_entities>0</all_entities>
		<hl>de</hl>
	</request>
	<results>
		<status>
			<description>ok</description>
		</status>
		<locations>
			<location>
				<description>Auvergne-Rhône-Alpes</description>
				<type>Region</type>
				<geoId>3099</geoId>
				<parentId>3079</parentId>
				<iso>FR</iso>
				<iso-3166-2>FR-ARA</iso-3166-2>
				<note></note>
				<events>
					<event>
						<description>Neujahr</description>
						<id>1</id>
						<dateStart>2022-01-01</dateStart>
						<dateEnd>2022-01-01</dateEnd>
						<class>1</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>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Tag der Arbeit</description>
						<id>22</id>
						<dateStart>2022-05-01</dateStart>
						<dateEnd>2022-05-01</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Tag des Sieges 1945</description>
						<id>97</id>
						<dateStart>2022-05-08</dateStart>
						<dateEnd>2022-05-08</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Christi Himmelfahrt</description>
						<id>31</id>
						<dateStart>2022-05-26</dateStart>
						<dateEnd>2022-05-26</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Pfingsten</description>
						<id>30</id>
						<dateStart>2022-06-05</dateStart>
						<dateEnd>2022-06-05</dateEnd>
						<class>4</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Pfingstmontag</description>
						<id>35</id>
						<dateStart>2022-06-06</dateStart>
						<dateEnd>2022-06-06</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Nationalfeiertag Frankreich</description>
						<id>96</id>
						<dateStart>2022-07-14</dateStart>
						<dateEnd>2022-07-14</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Mariä Himmelfahrt</description>
						<id>42</id>
						<dateStart>2022-08-15</dateStart>
						<dateEnd>2022-08-15</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Allerheiligen</description>
						<id>47</id>
						<dateStart>2022-11-01</dateStart>
						<dateEnd>2022-11-01</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Gedenktag 1918</description>
						<id>98</id>
						<dateStart>2022-11-11</dateStart>
						<dateEnd>2022-11-11</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Weihnachten</description>
						<id>23</id>
						<dateStart>2022-12-25</dateStart>
						<dateEnd>2022-12-25</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Weihnachtsferien</description>
						<id>812135</id>
						<dateStart>2021-12-19</dateStart>
						<dateEnd>2022-01-02</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Winterferien</description>
						<id>812136</id>
						<dateStart>2022-02-13</dateStart>
						<dateEnd>2022-02-27</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Frühlingsferien</description>
						<id>812137</id>
						<dateStart>2022-04-17</dateStart>
						<dateEnd>2022-05-01</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Auffahrtsferien</description>
						<id>812138</id>
						<dateStart>2022-05-26</dateStart>
						<dateEnd>2022-05-26</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Sommerferien</description>
						<id>812139</id>
						<dateStart>2022-07-07</dateStart>
						<dateEnd>2022-08-31</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Herbstferien</description>
						<id>826980</id>
						<dateStart>2022-10-22</dateStart>
						<dateEnd>2022-11-06</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Weihnachtsferien</description>
						<id>826981</id>
						<dateStart>2022-12-17</dateStart>
						<dateEnd>2023-01-02</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
				</events>
			</location>
			<location>
				<description>Bourgogne-Franche-Comté</description>
				<type>Region</type>
				<geoId>3101</geoId>
				<parentId>3079</parentId>
				<iso>FR</iso>
				<iso-3166-2>FR-BFC</iso-3166-2>
				<note></note>
				<events>
					<event>
						<description>Neujahr</description>
						<id>1</id>
						<dateStart>2022-01-01</dateStart>
						<dateEnd>2022-01-01</dateEnd>
						<class>1</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>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Tag der Arbeit</description>
						<id>22</id>
						<dateStart>2022-05-01</dateStart>
						<dateEnd>2022-05-01</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Tag des Sieges 1945</description>
						<id>97</id>
						<dateStart>2022-05-08</dateStart>
						<dateEnd>2022-05-08</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Christi Himmelfahrt</description>
						<id>31</id>
						<dateStart>2022-05-26</dateStart>
						<dateEnd>2022-05-26</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Pfingsten</description>
						<id>30</id>
						<dateStart>2022-06-05</dateStart>
						<dateEnd>2022-06-05</dateEnd>
						<class>4</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Pfingstmontag</description>
						<id>35</id>
						<dateStart>2022-06-06</dateStart>
						<dateEnd>2022-06-06</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Nationalfeiertag Frankreich</description>
						<id>96</id>
						<dateStart>2022-07-14</dateStart>
						<dateEnd>2022-07-14</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Mariä Himmelfahrt</description>
						<id>42</id>
						<dateStart>2022-08-15</dateStart>
						<dateEnd>2022-08-15</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Allerheiligen</description>
						<id>47</id>
						<dateStart>2022-11-01</dateStart>
						<dateEnd>2022-11-01</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Gedenktag 1918</description>
						<id>98</id>
						<dateStart>2022-11-11</dateStart>
						<dateEnd>2022-11-11</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Weihnachten</description>
						<id>23</id>
						<dateStart>2022-12-25</dateStart>
						<dateEnd>2022-12-25</dateEnd>
						<class>1</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Weihnachtsferien</description>
						<id>812232</id>
						<dateStart>2021-12-19</dateStart>
						<dateEnd>2022-01-02</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Winterferien</description>
						<id>812233</id>
						<dateStart>2022-02-13</dateStart>
						<dateEnd>2022-02-27</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Frühlingsferien</description>
						<id>812234</id>
						<dateStart>2022-04-17</dateStart>
						<dateEnd>2022-05-01</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Auffahrtsferien</description>
						<id>812236</id>
						<dateStart>2022-05-26</dateStart>
						<dateEnd>2022-05-26</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Sommerferien</description>
						<id>812235</id>
						<dateStart>2022-07-07</dateStart>
						<dateEnd>2022-08-31</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Herbstferien</description>
						<id>827049</id>
						<dateStart>2022-10-22</dateStart>
						<dateEnd>2022-11-06</dateEnd>
						<class>0</class>
						<percent>100</percent>
						<prov>0</prov>
						<note></note>
					</event>
					<event>
						<description>Weihnachtsferien</description>
						<id>827050</id>
						<dateStart>2022-12-17</dateStart>
						<dateEnd>2023-01-02</dateEnd>
						<class>0</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/index.php?api_key=YOUR_API_KEY&iso=FR&year=2022&format=csv

Antwort des APIs:

"location";"geoId";"iso";"iso_3166_2";"description";"id";"dateStart";"dateEnd";"class";"percent";"prov";"note"
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Neujahr";"1";"2022-01-01";"2022-01-01";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Ostermontag";"19";"2022-04-18";"2022-04-18";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Tag der Arbeit";"22";"2022-05-01";"2022-05-01";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Tag des Sieges 1945";"97";"2022-05-08";"2022-05-08";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Christi Himmelfahrt";"31";"2022-05-26";"2022-05-26";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Pfingsten";"30";"2022-06-05";"2022-06-05";"4";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Pfingstmontag";"35";"2022-06-06";"2022-06-06";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Nationalfeiertag Frankreich";"96";"2022-07-14";"2022-07-14";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Mariä Himmelfahrt";"42";"2022-08-15";"2022-08-15";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Allerheiligen";"47";"2022-11-01";"2022-11-01";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Gedenktag 1918";"98";"2022-11-11";"2022-11-11";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Weihnachten";"23";"2022-12-25";"2022-12-25";"1";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Weihnachtsferien";"812135";"2021-12-19";"2022-01-02";"0";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Winterferien";"812136";"2022-02-13";"2022-02-27";"0";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Frühlingsferien";"812137";"2022-04-17";"2022-05-01";"0";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Auffahrtsferien";"812138";"2022-05-26";"2022-05-26";"0";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Sommerferien";"812139";"2022-07-07";"2022-08-31";"0";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Herbstferien";"826980";"2022-10-22";"2022-11-06";"0";"100";"0";""
"Auvergne-Rhône-Alpes";"3099";"FR";"FR-ARA";"Weihnachtsferien";"826981";"2022-12-17";"2023-01-02";"0";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Neujahr";"1";"2022-01-01";"2022-01-01";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Ostermontag";"19";"2022-04-18";"2022-04-18";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Tag der Arbeit";"22";"2022-05-01";"2022-05-01";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Tag des Sieges 1945";"97";"2022-05-08";"2022-05-08";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Christi Himmelfahrt";"31";"2022-05-26";"2022-05-26";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Pfingsten";"30";"2022-06-05";"2022-06-05";"4";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Pfingstmontag";"35";"2022-06-06";"2022-06-06";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Nationalfeiertag Frankreich";"96";"2022-07-14";"2022-07-14";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Mariä Himmelfahrt";"42";"2022-08-15";"2022-08-15";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Allerheiligen";"47";"2022-11-01";"2022-11-01";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Gedenktag 1918";"98";"2022-11-11";"2022-11-11";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Weihnachten";"23";"2022-12-25";"2022-12-25";"1";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Weihnachtsferien";"812232";"2021-12-19";"2022-01-02";"0";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Winterferien";"812233";"2022-02-13";"2022-02-27";"0";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Frühlingsferien";"812234";"2022-04-17";"2022-05-01";"0";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Auffahrtsferien";"812236";"2022-05-26";"2022-05-26";"0";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Sommerferien";"812235";"2022-07-07";"2022-08-31";"0";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Herbstferien";"827049";"2022-10-22";"2022-11-06";"0";"100";"0";""
"Bourgogne-Franche-Comté";"3101";"FR";"FR-BFC";"Weihnachtsferien";"827050";"2022-12-17";"2023-01-02";"0";"100";"0";""

Fehlermeldungen

Art der Ausgabe	Fehlermeldung	Erläuterung
results: status:
results: status: description	not subscribed	Sie haben die gewünschten Daten nicht abonniert.
results: status: description	unknown location	Der angeforderte ISO-Ländercode ist nicht bekannt. Prüfen Sie bitte den Parameter ISO
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.

Entwickler-Ebene

Jahresdaten

Jahresdaten für mehrere Orte auslesen

API: Data/Country

Funktion

Interaktive Anleitung und OpenAPI

API-Kapitel

URL für Anfragen

Parameter für Anfragen

Beispiele (URL / PHP / Python / JavaScript)

Rückgabewerte des API

Beispiele (JSON / XML / CSV)

JSON

XML

CSV

Fehlermeldungen

Seiten

mehr von psc Informatik

Feiertagskalender.ch

Feiertagskalender unterstützen