API documentation

Geographical data

Read out Geo-IDs

using ISO country code Switzerland

API: GeoTree/CH

Get the geopraphic tree for all available entries of a country, based on an ISO country code (iso).

Function

This API reads the geographical tree of Switzerland. This allows the geoIds required for further queries to be determined. The required parameter is `api_key`. In addition, the output can be configured using further parameters. The parameters are passed as query parameters in the URL. Alternatively, authorisation can also take place in the header.

Interactive guide and OpenAPI

OpenAPI 3.0 (Swagger) – Interactive API documentation

Opens the interactive API documentation with Swagger, where you can test and explore API endpoints.

Download OpenAPI JSON specification

API Chapters

URL for requests
Request parameters
Examples (URL / PHP / Python / JavaScript)
Return values of the API
Examples (JSON / XML / CSV)
Error messages

URL for requests

To retrieve the data, use the following URL. Please pay attention to upper case lower case.

POST / GET

https://feiertagskalender.ch/api/GeoTree/CH/index.php

Request parameters

With the following variables you can complete the query and control the API results.

Parameter	Explanation	Examples
api_key required	Your API Key	api_key=abc-123-def-456
charset	The desired coding of the response Variants: UTF-8 (= default) ISO-8859-1	charset=iso-8859-1
format	The desired output format Variants: JSON (= default) XML CSV	format=xml
hl	Desired language of the output Variants: de = German (= default) fr = French it = Italian en = English	hl=en

Examples (URL / PHP / Python / JavaScript)

Show examples

Parameters in the URL

Parameters can be included in the URL (e.g. via the browser or in Excel):
Note: The first parameter is introduced with ?, all other parameters are introduced with &.

Important: This code must not be used directly in a website! For security reasons, API keys must only be processed in the backend.

https://feiertagskalender.ch/api/GeoTree/CH/index.php?api_key=YOUR_API_KEY&format=json&charset=utf-8&date_format=Y-m-d

Example PHP with cURL (GET)

$api_url = "https://feiertagskalender.ch/api/GeoTree/CH/index.php?format=json&charset=utf-8&date_format=Y-m-d";
$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;

Example PHP with cURL (POST)

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

// POST-Daten
$post_data = json_encode([
    "format": "json",
    "charset": "utf-8",
    "date_format": "Y-m-d"	
]);

$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;

Example Python with requests (GET)

import requests

api_key = "YOUR_API_KEY"
api_url = "https://feiertagskalender.ch/api/GeoTree/CH/index.php?format=json&charset=utf-8&date_format=Y-m-d"
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)

Example Python with requests (POST)

import requests

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

payload = {
    "format": "json",
    "charset": "utf-8",
    "date_format": "Y-m-d"	
}

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)

Example JavaScript with Fetch API (GET)

The Fetch API is a modern method for executing HTTP requests in JavaScript. It is supported in current browsers.

Important: This code must not be used directly in a website! For security reasons, API keys must only be processed in the backend.

const apiUrl = "https://feiertagskalender.ch/api/GeoTree/CH/index.php?format=json&charset=utf-8&date_format=Y-m-d";
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));

Example JavaScript with Fetch API (POST)

The Fetch API is a modern method for executing HTTP requests in JavaScript. It is supported in current browsers.

const apiUrl = "https://feiertagskalender.ch/api/GeoTree/CH/index.php";
const apiKey = "YOUR_API_KEY";  
const requestData = {
    "format": "json",
    "charset": "utf-8",
    "date_format": "Y-m-d"	
};

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

Return values of the API

The contents of the API responses result from:
- the data you have subscribed to (countries, public holidays, school holidays, calendar years)
- the officially known data of the legislators
- the availability based on our research (ACTUAL situation of our database)

Please note that the output in CSV format differs.

Array				Explanation	Example
interface				Version of the API
source:	href			URL to the data source (website)
	description			Name of the data source
copyright	href			URL to the copyright holder (website)
	description			Designation of the copyright holder
apiName				Identification of the API	GeoTree/CH
apiStatus	description			Designation of the API status. For variants, see the Error messages	active
date				Date of the data export	01.05.2025
request:	iso			ISO country code, 2 digits	CH
	charset			Font coding of the output	utf-8
	format			Output data format	json
	hl			Language of issue, according to request	en
results	status	description		Output status. For variants, see the Error messages	ok
	location			Geographical unit according to request
		description		Designation of the geographical unit	Switzerland
		type		Designation of the type of geographical unit	Country
		geoId		Geo-ID of the geographical unit.	3056
		iso		ISO country code, 2 digits	CH
		iso-3166-2		Region code according to ISO 3166-2
		bfs		FSO community number (Only available at municipality level)	NULL
		children		Any subordinate geographical units
			description	Designation of the geographical unit	Argovia
			type	Designation of the type of geographical unit	Canton
			geoId	Geo-ID of the geographical unit.	1
			iso	ISO country code, 2 digits	CH
			iso-3166-2	Region code according to ISO 3166-2	CH-AG
			bfs	FSO community number (Only available at municipality level)
			children	Any subordinate geographical units (1-3 levels, depending on canton)	array

Examples (JSON / XML / CSV)

JSON

URL:
https://www.feiertagskalender.ch/api/GeoTree/CH/index.php?api_key=YOUR_API_KEY&format=json&charset=utf-8&date_format=Y-m-d

Response from the 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": "GeoTree/CH",
    "apiStatus": {
        "description": "active"
    },
    "date": "2025-02-28",
    "request": {
        "iso": "CH",
        "charset": "utf-8",
        "format": "json",
        "hl": "de"
    },
    "results": {
        "status": {
            "description": "ok"
        },
        "location": {
            "description": "Schweiz",
            "type": "Land",
            "geoId": "3056",
            "iso": "CH",
            "iso-3166-2": "",
            "bfs": null,
            "children": [
                {
                    "description": "Aargau",
                    "type": "Kanton",
                    "geoId": "1",
                    "iso": "CH",
                    "iso-3166-2": "CH-AG",
                    "bfs": null,
                    "children": [
                        {
                            "description": "Aarau",
                            "type": "Bezirk",
                            "geoId": "2",
                            "iso": "CH",
                            "iso-3166-2": "CH-AG",
                            "bfs": null,
                            "children": [
                                {
                                    "description": "Aarau",
                                    "type": "Gemeinde",
                                    "geoId": "3",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4001",
                                    "children": null
                                },
                                {
                                    "description": "Biberstein",
                                    "type": "Gemeinde",
                                    "geoId": "4",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4002",
                                    "children": null
                                },
                                {
                                    "description": "Buchs (AG)",
                                    "type": "Gemeinde",
                                    "geoId": "5",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4003",
                                    "children": null
                                },
                                {
                                    "description": "Densbüren",
                                    "type": "Gemeinde",
                                    "geoId": "6",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4004",
                                    "children": null
                                },
                                {
                                    "description": "Erlinsbach (AG)",
                                    "type": "Gemeinde",
                                    "geoId": "7",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4005",
                                    "children": null
                                },
                                {
                                    "description": "Gränichen",
                                    "type": "Gemeinde",
                                    "geoId": "8",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4006",
                                    "children": null
                                },
                                {
                                    "description": "Hirschthal",
                                    "type": "Gemeinde",
                                    "geoId": "9",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4007",
                                    "children": null
                                },
                                {
                                    "description": "Küttigen",
                                    "type": "Gemeinde",
                                    "geoId": "10",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4008",
                                    "children": null
                                },
                                {
                                    "description": "Muhen",
                                    "type": "Gemeinde",
                                    "geoId": "11",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4009",
                                    "children": null
                                },
                                {
                                    "description": "Oberentfelden",
                                    "type": "Gemeinde",
                                    "geoId": "12",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4010",
                                    "children": null
                                },
                                {
                                    "description": "Suhr",
                                    "type": "Gemeinde",
                                    "geoId": "14",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4012",
                                    "children": null
                                },
                                {
                                    "description": "Unterentfelden",
                                    "type": "Gemeinde",
                                    "geoId": "15",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4013",
                                    "children": null
                                }
                            ]
                        },
                        {
                            "description": "Baden",
                            "type": "Bezirk",
                            "geoId": "16",
                            "iso": "CH",
                            "iso-3166-2": "CH-AG",
                            "bfs": null,
                            "children": [
                                {
                                    "description": "Baden",
                                    "type": "Gemeinde",
                                    "geoId": "17",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4021",
                                    "children": null
                                },
                                {
                                    "description": "Bellikon",
                                    "type": "Gemeinde",
                                    "geoId": "18",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4022",
                                    "children": null
                                },
                                {
                                    "description": "Bergdietikon",
                                    "type": "Gemeinde",
                                    "geoId": "19",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4023",
                                    "children": null
                                },
                                {
                                    "description": "Birmenstorf (AG)",
                                    "type": "Gemeinde",
                                    "geoId": "20",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4024",
                                    "children": null
                                },
                                {
                                    "description": "Ehrendingen",
                                    "type": "Gemeinde",
                                    "geoId": "31",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4049",
                                    "children": null
                                },
                                {
                                    "description": "Ennetbaden",
                                    "type": "Gemeinde",
                                    "geoId": "21",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4026",
                                    "children": null
                                },
                                {
                                    "description": "Fislisbach",
                                    "type": "Gemeinde",
                                    "geoId": "22",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4027",
                                    "children": null
                                },
                                {
                                    "description": "Freienwil",
                                    "type": "Gemeinde",
                                    "geoId": "23",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4028",
                                    "children": null
                                },
                                {
                                    "description": "Gebenstorf",
                                    "type": "Gemeinde",
                                    "geoId": "24",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4029",
                                    "children": null
                                },
                                {
                                    "description": "Killwangen",
                                    "type": "Gemeinde",
                                    "geoId": "25",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4030",
                                    "children": null
                                },
                                {
                                    "description": "Künten",
                                    "type": "Gemeinde",
                                    "geoId": "26",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4031",
                                    "children": null
                                },
                                {
                                    "description": "Mägenwil",
                                    "type": "Gemeinde",
                                    "geoId": "27",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4032",
                                    "children": null
                                },
                                {
                                    "description": "Mellingen",
                                    "type": "Gemeinde",
                                    "geoId": "28",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4033",
                                    "children": null
                                },
                                {
                                    "description": "Neuenhof",
                                    "type": "Gemeinde",
                                    "geoId": "29",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4034",
                                    "children": null
                                },
                                {
                                    "description": "Niederrohrdorf",
                                    "type": "Gemeinde",
                                    "geoId": "30",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4035",
                                    "children": null
                                },
                                {
                                    "description": "Oberrohrdorf",
                                    "type": "Gemeinde",
                                    "geoId": "32",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4037",
                                    "children": null
                                },
                                {
                                    "description": "Obersiggenthal",
                                    "type": "Gemeinde",
                                    "geoId": "33",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4038",
                                    "children": null
                                },
                                {
                                    "description": "Remetschwil",
                                    "type": "Gemeinde",
                                    "geoId": "34",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4039",
                                    "children": null
                                },
                                {
                                    "description": "Spreitenbach",
                                    "type": "Gemeinde",
                                    "geoId": "35",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4040",
                                    "children": null
                                },
                                {
                                    "description": "Stetten (AG)",
                                    "type": "Gemeinde",
                                    "geoId": "36",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4041",
                                    "children": null
                                },
                                {
                                    "description": "Untersiggenthal",
                                    "type": "Gemeinde",
                                    "geoId": "39",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4044",
                                    "children": null
                                },
                                {
                                    "description": "Wettingen",
                                    "type": "Gemeinde",
                                    "geoId": "40",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4045",
                                    "children": null
                                },
                                {
                                    "description": "Wohlenschwil",
                                    "type": "Gemeinde",
                                    "geoId": "41",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4046",
                                    "children": null
                                },
                                {
                                    "description": "Würenlingen",
                                    "type": "Gemeinde",
                                    "geoId": "42",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4047",
                                    "children": null
                                },
                                {
                                    "description": "Würenlos",
                                    "type": "Gemeinde",
                                    "geoId": "43",
                                    "iso": "CH",
                                    "iso-3166-2": "CH-AG",
                                    "bfs": "4048",
                                    "children": null
                                }
                            ]
                        }
                    ]
                }
            ]
        }
    }
}

XML

URL:
https://www.feiertagskalender.ch/api/GeoTree/CH/index.php?api_key=YOUR_API_KEY&format=json&charset=utf-8&date_format=Y-m-d&format=xml

Response from the 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>GeoTree/CH</apiName>
<date>2025-02-28</date>
<request>
<iso>CH</iso>
<charset>utf-8</charset>
<format>xml</format>
<hl>de</hl>
</request>
<results>
<status>
<description>ok</description>
</status>
<location>
<description>Schweiz</description>
<type>Land</type>
<geoId>3056</geoId>
<iso>CH</iso>
<iso-3166-2></iso-3166-2>
<bfs></bfs>
<children>
<child>
<description>Aargau</description>
<type>Kanton</type>
<geoId>1</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs></bfs>
<children>
<child>
<description>Aarau</description>
<type>Bezirk</type>
<geoId>2</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs></bfs>
<children>
<child>
<description>Aarau</description>
<type>Gemeinde</type>
<geoId>3</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4001</bfs>
<children></children>
</child>
<child>
<description>Biberstein</description>
<type>Gemeinde</type>
<geoId>4</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4002</bfs>
<children></children>
</child>
<child>
<description>Buchs (AG)</description>
<type>Gemeinde</type>
<geoId>5</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4003</bfs>
<children></children>
</child>
<child>
<description>Densbüren</description>
<type>Gemeinde</type>
<geoId>6</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4004</bfs>
<children></children>
</child>
<child>
<description>Erlinsbach (AG)</description>
<type>Gemeinde</type>
<geoId>7</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4005</bfs>
<children></children>
</child>
<child>
<description>Gränichen</description>
<type>Gemeinde</type>
<geoId>8</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4006</bfs>
<children></children>
</child>
<child>
<description>Hirschthal</description>
<type>Gemeinde</type>
<geoId>9</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4007</bfs>
<children></children>
</child>
<child>
<description>Küttigen</description>
<type>Gemeinde</type>
<geoId>10</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4008</bfs>
<children></children>
</child>
<child>
<description>Muhen</description>
<type>Gemeinde</type>
<geoId>11</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4009</bfs>
<children></children>
</child>
<child>
<description>Oberentfelden</description>
<type>Gemeinde</type>
<geoId>12</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4010</bfs>
<children></children>
</child>
<child>
<description>Suhr</description>
<type>Gemeinde</type>
<geoId>14</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4012</bfs>
<children></children>
</child>
<child>
<description>Unterentfelden</description>
<type>Gemeinde</type>
<geoId>15</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4013</bfs>
<children></children>
</child>

</children>
</child>
<child>
<description>Baden</description>
<type>Bezirk</type>
<geoId>16</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs></bfs>
<children>
<child>
<description>Baden</description>
<type>Gemeinde</type>
<geoId>17</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4021</bfs>
<children></children>
</child>
<child>
<description>Bellikon</description>
<type>Gemeinde</type>
<geoId>18</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4022</bfs>
<children></children>
</child>
<child>
<description>Bergdietikon</description>
<type>Gemeinde</type>
<geoId>19</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4023</bfs>
<children></children>
</child>
<child>
<description>Birmenstorf (AG)</description>
<type>Gemeinde</type>
<geoId>20</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4024</bfs>
<children></children>
</child>
<child>
<description>Ehrendingen</description>
<type>Gemeinde</type>
<geoId>31</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4049</bfs>
<children></children>
</child>
<child>
<description>Ennetbaden</description>
<type>Gemeinde</type>
<geoId>21</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4026</bfs>
<children></children>
</child>
<child>
<description>Fislisbach</description>
<type>Gemeinde</type>
<geoId>22</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4027</bfs>
<children></children>
</child>
<child>
<description>Freienwil</description>
<type>Gemeinde</type>
<geoId>23</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4028</bfs>
<children></children>
</child>
<child>
<description>Gebenstorf</description>
<type>Gemeinde</type>
<geoId>24</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4029</bfs>
<children></children>
</child>
<child>
<description>Killwangen</description>
<type>Gemeinde</type>
<geoId>25</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4030</bfs>
<children></children>
</child>
<child>
<description>Künten</description>
<type>Gemeinde</type>
<geoId>26</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4031</bfs>
<children></children>
</child>
<child>
<description>Mägenwil</description>
<type>Gemeinde</type>
<geoId>27</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4032</bfs>
<children></children>
</child>
<child>
<description>Mellingen</description>
<type>Gemeinde</type>
<geoId>28</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4033</bfs>
<children></children>
</child>
<child>
<description>Neuenhof</description>
<type>Gemeinde</type>
<geoId>29</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4034</bfs>
<children></children>
</child>
<child>
<description>Niederrohrdorf</description>
<type>Gemeinde</type>
<geoId>30</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4035</bfs>
<children></children>
</child>
<child>
<description>Oberrohrdorf</description>
<type>Gemeinde</type>
<geoId>32</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4037</bfs>
<children></children>
</child>
<child>
<description>Obersiggenthal</description>
<type>Gemeinde</type>
<geoId>33</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4038</bfs>
<children></children>
</child>
<child>
<description>Remetschwil</description>
<type>Gemeinde</type>
<geoId>34</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4039</bfs>
<children></children>
</child>
<child>
<description>Spreitenbach</description>
<type>Gemeinde</type>
<geoId>35</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4040</bfs>
<children></children>
</child>
<child>
<description>Stetten (AG)</description>
<type>Gemeinde</type>
<geoId>36</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4041</bfs>
<children></children>
</child>
<child>
<description>Untersiggenthal</description>
<type>Gemeinde</type>
<geoId>39</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4044</bfs>
<children></children>
</child>
<child>
<description>Wettingen</description>
<type>Gemeinde</type>
<geoId>40</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4045</bfs>
<children></children>
</child>
<child>
<description>Wohlenschwil</description>
<type>Gemeinde</type>
<geoId>41</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4046</bfs>
<children></children>
</child>
<child>
<description>Würenlingen</description>
<type>Gemeinde</type>
<geoId>42</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4047</bfs>
<children></children>
</child>
<child>
<description>Würenlos</description>
<type>Gemeinde</type>
<geoId>43</geoId>
<iso>CH</iso>
<iso-3166-2>CH-AG</iso-3166-2>
<bfs>4048</bfs>
<children></children>
</child>

</children>
</child>


</children>
</child>

</children>
</location>
</results>
</fcal_api>

CSV

Aufruf:
https://www.feiertagskalender.ch/api/GeoTree/CH/index.php?api_key=YOUR_API_KEY&format=json&charset=utf-8&date_format=Y-m-d&format=CSV

Response from the API:

"location_L0";"type_L0";"iso";"geoId_L0";"iso-3166-2";"location_L1";"type_L1";"geoId_L1";"location_L2";"type_L2";"geoId_L2";"location_L3";"type_L3";"geoId_L3";"bfs"
"Schweiz";"Land";"CH";"3056";"";"";"";"";"";"";"";"";"";"";""
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"";"";"";"";"";"";""
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Aarau";"Bezirk";"2";"";"";"";""
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Aarau";"Bezirk";"2";"Aarau";"Gemeinde";"3";"4001"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Aarau";"Bezirk";"2";"Biberstein";"Gemeinde";"4";"4002"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Aarau";"Bezirk";"2";"Buchs (AG)";"Gemeinde";"5";"4003"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Aarau";"Bezirk";"2";"Densbüren";"Gemeinde";"6";"4004"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Aarau";"Bezirk";"2";"Erlinsbach (AG)";"Gemeinde";"7";"4005"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Aarau";"Bezirk";"2";"Gränichen";"Gemeinde";"8";"4006"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Aarau";"Bezirk";"2";"Hirschthal";"Gemeinde";"9";"4007"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Aarau";"Bezirk";"2";"Küttigen";"Gemeinde";"10";"4008"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Aarau";"Bezirk";"2";"Muhen";"Gemeinde";"11";"4009"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Aarau";"Bezirk";"2";"Oberentfelden";"Gemeinde";"12";"4010"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Aarau";"Bezirk";"2";"Suhr";"Gemeinde";"14";"4012"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Aarau";"Bezirk";"2";"Unterentfelden";"Gemeinde";"15";"4013"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"";"";"";""
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Baden";"Gemeinde";"17";"4021"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Bellikon";"Gemeinde";"18";"4022"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Bergdietikon";"Gemeinde";"19";"4023"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Birmenstorf (AG)";"Gemeinde";"20";"4024"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Ehrendingen";"Gemeinde";"31";"4049"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Ennetbaden";"Gemeinde";"21";"4026"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Fislisbach";"Gemeinde";"22";"4027"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Freienwil";"Gemeinde";"23";"4028"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Gebenstorf";"Gemeinde";"24";"4029"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Killwangen";"Gemeinde";"25";"4030"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Künten";"Gemeinde";"26";"4031"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Mägenwil";"Gemeinde";"27";"4032"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Mellingen";"Gemeinde";"28";"4033"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Neuenhof";"Gemeinde";"29";"4034"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Niederrohrdorf";"Gemeinde";"30";"4035"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Oberrohrdorf";"Gemeinde";"32";"4037"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Obersiggenthal";"Gemeinde";"33";"4038"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Remetschwil";"Gemeinde";"34";"4039"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Spreitenbach";"Gemeinde";"35";"4040"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Stetten (AG)";"Gemeinde";"36";"4041"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Untersiggenthal";"Gemeinde";"39";"4044"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Wettingen";"Gemeinde";"40";"4045"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Wohlenschwil";"Gemeinde";"41";"4046"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Würenlingen";"Gemeinde";"42";"4047"
"Schweiz";"Land";"CH";"3056";"Aargau";"Kanton";"CH-AG";"1";"Baden";"Bezirk";"16";"Würenlos";"Gemeinde";"43";"4048"

Error messages

Output location	Error message	Explanation
apiStatus
apiStatus: description	invalid usage	The use of this API is not enabled for this user.
apiStatus: description	invalid key	Invalid API key.
apiStatus: description	invalid referer	Invalid access. Links from web pages (front-ends) are not allowed.
apiStatus: description	inactive	The API has not yet been activated for use.
apiStatus: description	expired	The period of use according to the contract has expired.

Developer area

Geographical data

Read out Geo-IDs

API: GeoTree/CH

Function

Interactive guide and OpenAPI

API Chapters

URL for requests

Request parameters

Examples (URL / PHP / Python / JavaScript)

Return values of the API

Examples (JSON / XML / CSV)

JSON

XML

CSV

Error messages

Pages

more from psc Informatik

Feiertagskalender.ch

Support public holiday calendar