API documentation

Annual data

API: Data/Aggreg

Retrieves aggregated public holiday and school holiday data for an entire year and shows the affected population shares of a region or country.

Function

This API indicates on which days of the year there are public holidays or school holidays in a particular region or country and what percentage of the population is affected. The required parameters are `api_key` and `iso`. The `year` parameter is optional - if it is not specified, the current year is automatically used. 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

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

POST / GET 
https://feiertagskalender.ch/api/Data/Aggreg/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
iso
required		 ISO country code, 2 digits, or
Region code according to ISO 3166-2		 iso=DE-BW
year
or
jahr

Year of the requested dates

without specification: current calendar year (= default)

 year= 2026
class
or
klasse

Scope of the data

Variants:
0 = school holidays only
3 = 0 + public holidays recognised by law
4 = 0 + 3 + public and non-statutory holidays (religious, cultural) (= default)
5 = 0 + 3 + 4 + event days (e.g. Valentine's Day, Mother's Day, Advent Sundays)

 klasse=5
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
date_format

The desired date format for the response. Default: `Y-m-d` (e.g., 2025-12-31)
The format corresponds to the date formatting of the PHP instruction date()

Variants:
Y-m-d = YYYY-MM-DD (ISO-8601) (= default)
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

Desired language of the output

Variants:
de = German (= default)
fr = French
it = Italian
en = English

hl=en
compact

Flag for compact data output

Variants:
0 = Output includes all days of the year, even if no event occurs.
1 = Output only includes days on which school holidays, and/or a public holiday occurs. (= default)

 &compact=0
filter Filter setting for public holidays in percent

Variants:
0 = the output contains all registered holidays
5 = The output only contains public holidays whose share is > 5% (= default)
The filtering works with integer numbers from 0 to 100. 		&filter=0

Examples (URL / PHP / Python / JavaScript)

Show examples

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 Data/Aggreg
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 DE
  year       Year of the data in the output 2015
  charset       Font coding of the output utf-8
  format       Output data format json
  date_format       Output date format d.m.Y
  hl       Language of issue, according to request en
  compact       Flag für kompakte Ausgabe, gemäss Anfrage 1
  filter       Filterwert für Unterdrückung der Ausgabe von Feiertagen 0
results status description     Output status. For variants, see the Error messages ok
  location description     Designation of the geographical unit Deutschland
    type     Designation of the type of geographical unit Land
    geoId     Geo-ID of the geographical unit. 3059
    iso     ISO country code, 2 digits DE
    iso-3166-2     Region code according to ISO 3166-2  
    calendar     die Kalenderausgabe  
      date   Datum des Kalenders 2019-01-06
      total_population   Anzahl Einwohner im gewählten Gebiet 81835000
      public_holiday_population   Anzahl Einwohner, betroffen von einem Feiertag 25346076
      public_holiday_percent   Prozentualer Anteil der Einwohner, betroffen von einem Feiertag 30.97217083155129
      public_holiday_description   Bezeichnung Feiertag Heilige drei Könige
      school_holiday_population   Anzahl Einwohner, betroffen von Schulferien 81835000
      school_holiday_percent   Prozentualer Anteil der Einwohner, betroffen von Schulferien 100
      school_holiday_description   Designation school holidays Weihnachtsferien
      sum_population   Summe aus public_holiday_population und school_holiday_population 81835000
      sum_percent   Summe aus public_holiday_percent und school_holiday_percent 100

Examples (JSON / XML / CSV)

JSON

URL:
https://www.feiertagskalender.ch/api/Data/Aggreg/index.php?api_key=YOUR_API_KEY&iso=CH&year=2015 

{
    "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/Aggreg",
    "apiStatus": {
        "description": "active"
    },
    "date": "2025-02-25",
    "request": {
        "iso": "CH",
        "year": 2015,
        "charset": "utf-8",
        "format": "json",
        "date_format": "Y-m-d",
        "hl": "de",
        "compact": "1",
        "filter": "5"
    },
    "results": {
        "status": {
            "description": "ok"
        },
        "location": {
            "description": "Schweiz",
            "type": "Land",
            "geoId": "3056",
            "iso": "CH",
            "iso-3166-2": "",
            "note": "",
            "calendar": [
                {
                    "datum": "2015-01-01",
                    "total_population": 8669730,
                    "public_holiday_population": 8669730,
                    "public_holiday_percent": 100,
                    "public_holiday_description": "Neujahr",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 8669730,
                    "sum_percent": 100
                },
                {
                    "datum": "2015-01-02",
                    "total_population": 8669730,
                    "public_holiday_population": 5433386,
                    "public_holiday_percent": 62.67076368006846,
                    "public_holiday_description": "Berchtoldstag",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 5433386,
                    "sum_percent": 62.67076368006846
                },
                {
                    "datum": "2015-01-06",
                    "total_population": 8669730,
                    "public_holiday_population": 568122,
                    "public_holiday_percent": 6.552937634736029,
                    "public_holiday_description": "Heilige drei Könige",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 568122,
                    "sum_percent": 6.552937634736029
                },
                {
                    "datum": "2015-02-16",
                    "total_population": 8669730,
                    "public_holiday_population": 487825,
                    "public_holiday_percent": 5.626761156345123,
                    "public_holiday_description": "Fasnachtsmontag",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 487825,
                    "sum_percent": 5.626761156345123
                },
                {
                    "datum": "2015-03-19",
                    "total_population": 8669730,
                    "public_holiday_population": 1014489,
                    "public_holiday_percent": 11.701506275281929,
                    "public_holiday_description": "St. Josef",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 1014489,
                    "sum_percent": 11.701506275281929
                },
                {
                    "datum": "2015-04-03",
                    "total_population": 8669730,
                    "public_holiday_population": 7970642,
                    "public_holiday_percent": 91.93645015473378,
                    "public_holiday_description": "Karfreitag",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 7970642,
                    "sum_percent": 91.93645015473378
                },
                {
                    "datum": "2015-04-05",
                    "total_population": 8669730,
                    "public_holiday_population": 8669730,
                    "public_holiday_percent": 100,
                    "public_holiday_description": "Ostern",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 8669730,
                    "sum_percent": 100
                },
                {
                    "datum": "2015-04-06",
                    "total_population": 8669730,
                    "public_holiday_population": 8669730,
                    "public_holiday_percent": 100,
                    "public_holiday_description": "Ostermontag",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 8669730,
                    "sum_percent": 100
                },
                {
                    "datum": "2015-05-01",
                    "total_population": 8669730,
                    "public_holiday_population": 3293934,
                    "public_holiday_percent": 37.99350152772924,
                    "public_holiday_description": "Heiliger Sigismund",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 3293934,
                    "sum_percent": 37.99350152772924
                },
                {
                    "datum": "2015-05-14",
                    "total_population": 8669730,
                    "public_holiday_population": 8669730,
                    "public_holiday_percent": 100,
                    "public_holiday_description": "Auffahrt",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 8669730,
                    "sum_percent": 100
                },
                {
                    "datum": "2015-05-24",
                    "total_population": 8669730,
                    "public_holiday_population": 8669730,
                    "public_holiday_percent": 100,
                    "public_holiday_description": "Pfingsten",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 8669730,
                    "sum_percent": 100
                },
                {
                    "datum": "2015-05-25",
                    "total_population": 8669730,
                    "public_holiday_population": 8669730,
                    "public_holiday_percent": 100,
                    "public_holiday_description": "Pfingstmontag",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 8669730,
                    "sum_percent": 100
                },
                {
                    "datum": "2015-06-04",
                    "total_population": 8669730,
                    "public_holiday_population": 2574694,
                    "public_holiday_percent": 29.697510764464408,
                    "public_holiday_description": "Fronleichnam",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 2574694,
                    "sum_percent": 29.697510764464408
                },
                {
                    "datum": "2015-08-01",
                    "total_population": 8669730,
                    "public_holiday_population": 8669730,
                    "public_holiday_percent": 100,
                    "public_holiday_description": "Nationalfeiertag Schweiz",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 8669730,
                    "sum_percent": 100
                },
                {
                    "datum": "2015-08-15",
                    "total_population": 8669730,
                    "public_holiday_population": 2396949,
                    "public_holiday_percent": 27.6473315778,
                    "public_holiday_description": "Mariä Himmelfahrt",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 2396949,
                    "sum_percent": 27.6473315778
                },
                {
                    "datum": "2015-09-10",
                    "total_population": 8669730,
                    "public_holiday_population": 506343,
                    "public_holiday_percent": 5.84035488994467,
                    "public_holiday_description": "Genfer Bettag",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 506343,
                    "sum_percent": 5.84035488994467
                },
                {
                    "datum": "2015-09-14",
                    "total_population": 8669730,
                    "public_holiday_population": 447366,
                    "public_holiday_percent": 5.160091490738465,
                    "public_holiday_description": "Heiligkreuztag",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 447366,
                    "sum_percent": 5.160091490738465
                },
                {
                    "datum": "2015-09-21",
                    "total_population": 8669730,
                    "public_holiday_population": 1033118,
                    "public_holiday_percent": 11.91638032556954,
                    "public_holiday_description": "Thuner Ausschiesset",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 1033118,
                    "sum_percent": 11.91638032556954
                },
                {
                    "datum": "2015-11-01",
                    "total_population": 8669730,
                    "public_holiday_population": 3959170,
                    "public_holiday_percent": 45.66658938629,
                    "public_holiday_description": "Reformationssonntag Schweiz",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 3959170,
                    "sum_percent": 45.66658938629
                },
                {
                    "datum": "2015-12-08",
                    "total_population": 8669730,
                    "public_holiday_population": 1937868,
                    "public_holiday_percent": 22.352114771740297,
                    "public_holiday_description": "Mariä Empfängnis",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 1937868,
                    "sum_percent": 22.352114771740297
                },
                {
                    "datum": "2015-12-25",
                    "total_population": 8669730,
                    "public_holiday_population": 8669730,
                    "public_holiday_percent": 100,
                    "public_holiday_description": "Weihnachten",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 8669730,
                    "sum_percent": 100
                },
                {
                    "datum": "2015-12-26",
                    "total_population": 8669730,
                    "public_holiday_population": 6562253,
                    "public_holiday_percent": 75.69154979451494,
                    "public_holiday_description": "Stephanstag",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 6562253,
                    "sum_percent": 75.69154979451494
                },
                {
                    "datum": "2015-12-31",
                    "total_population": 8669730,
                    "public_holiday_population": 509784,
                    "public_holiday_percent": 5.880044707274621,
                    "public_holiday_description": "Silvester",
                    "school_holiday_population": 0,
                    "school_holiday_percent": 0,
                    "school_holiday_description": "",
                    "sum_population": 509784,
                    "sum_percent": 5.880044707274621
                }
            ]
        }
    }
}

XML

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

Response from the API:

<fcal_api>
<interface>fcal API 2.01</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/Aggreg</apiName>
<date>2025-02-25</date>
<request>
<iso>CH</iso>
<year>2015</year>
<charset>utf-8</charset>
<format>xml</format>
<date_format>Y-m-d</date_format>
<hl>de</hl>
<compact>1</compact>
<filter>5</filter>
</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>
<note></note>
<events>
<day>
<datum>2015-01-01</datum>
<total_population>8669730</total_population>
<public_holiday_population>8669730</public_holiday_population>
<public_holiday_percent>100</public_holiday_percent>
<public_holiday_description>Neujahr</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>8669730</sum_population>
<sum_percent>100</sum_percent>
</day>
<day>
<datum>2015-01-02</datum>
<total_population>8669730</total_population>
<public_holiday_population>5433386</public_holiday_population>
<public_holiday_percent>62.670763680068</public_holiday_percent>
<public_holiday_description>Berchtoldstag</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>5433386</sum_population>
<sum_percent>62.670763680068</sum_percent>
</day>
<day>
<datum>2015-01-06</datum>
<total_population>8669730</total_population>
<public_holiday_population>568122</public_holiday_population>
<public_holiday_percent>6.552937634736</public_holiday_percent>
<public_holiday_description>Heilige drei Könige</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>568122</sum_population>
<sum_percent>6.552937634736</sum_percent>
</day>
<day>
<datum>2015-02-16</datum>
<total_population>8669730</total_population>
<public_holiday_population>487825</public_holiday_population>
<public_holiday_percent>5.6267611563451</public_holiday_percent>
<public_holiday_description>Fasnachtsmontag</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>487825</sum_population>
<sum_percent>5.6267611563451</sum_percent>
</day>
<day>
<datum>2015-03-19</datum>
<total_population>8669730</total_population>
<public_holiday_population>1014489</public_holiday_population>
<public_holiday_percent>11.701506275282</public_holiday_percent>
<public_holiday_description>St. Josef</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>1014489</sum_population>
<sum_percent>11.701506275282</sum_percent>
</day>
<day>
<datum>2015-04-03</datum>
<total_population>8669730</total_population>
<public_holiday_population>7970642</public_holiday_population>
<public_holiday_percent>91.936450154734</public_holiday_percent>
<public_holiday_description>Karfreitag</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>7970642</sum_population>
<sum_percent>91.936450154734</sum_percent>
</day>
<day>
<datum>2015-04-05</datum>
<total_population>8669730</total_population>
<public_holiday_population>8669730</public_holiday_population>
<public_holiday_percent>100</public_holiday_percent>
<public_holiday_description>Ostern</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>8669730</sum_population>
<sum_percent>100</sum_percent>
</day>
<day>
<datum>2015-04-06</datum>
<total_population>8669730</total_population>
<public_holiday_population>8669730</public_holiday_population>
<public_holiday_percent>100</public_holiday_percent>
<public_holiday_description>Ostermontag</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>8669730</sum_population>
<sum_percent>100</sum_percent>
</day>
<day>
<datum>2015-05-01</datum>
<total_population>8669730</total_population>
<public_holiday_population>3293934</public_holiday_population>
<public_holiday_percent>37.993501527729</public_holiday_percent>
<public_holiday_description>Heiliger Sigismund</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>3293934</sum_population>
<sum_percent>37.993501527729</sum_percent>
</day>
<day>
<datum>2015-05-14</datum>
<total_population>8669730</total_population>
<public_holiday_population>8669730</public_holiday_population>
<public_holiday_percent>100</public_holiday_percent>
<public_holiday_description>Auffahrt</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>8669730</sum_population>
<sum_percent>100</sum_percent>
</day>
<day>
<datum>2015-05-24</datum>
<total_population>8669730</total_population>
<public_holiday_population>8669730</public_holiday_population>
<public_holiday_percent>100</public_holiday_percent>
<public_holiday_description>Pfingsten</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>8669730</sum_population>
<sum_percent>100</sum_percent>
</day>
<day>
<datum>2015-05-25</datum>
<total_population>8669730</total_population>
<public_holiday_population>8669730</public_holiday_population>
<public_holiday_percent>100</public_holiday_percent>
<public_holiday_description>Pfingstmontag</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>8669730</sum_population>
<sum_percent>100</sum_percent>
</day>
<day>
<datum>2015-06-04</datum>
<total_population>8669730</total_population>
<public_holiday_population>2574694</public_holiday_population>
<public_holiday_percent>29.697510764464</public_holiday_percent>
<public_holiday_description>Fronleichnam</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>2574694</sum_population>
<sum_percent>29.697510764464</sum_percent>
</day>
<day>
<datum>2015-08-01</datum>
<total_population>8669730</total_population>
<public_holiday_population>8669730</public_holiday_population>
<public_holiday_percent>100</public_holiday_percent>
<public_holiday_description>Nationalfeiertag Schweiz</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>8669730</sum_population>
<sum_percent>100</sum_percent>
</day>
<day>
<datum>2015-08-15</datum>
<total_population>8669730</total_population>
<public_holiday_population>2396949</public_holiday_population>
<public_holiday_percent>27.6473315778</public_holiday_percent>
<public_holiday_description>Mariä Himmelfahrt</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>2396949</sum_population>
<sum_percent>27.6473315778</sum_percent>
</day>
<day>
<datum>2015-09-10</datum>
<total_population>8669730</total_population>
<public_holiday_population>506343</public_holiday_population>
<public_holiday_percent>5.8403548899447</public_holiday_percent>
<public_holiday_description>Genfer Bettag</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>506343</sum_population>
<sum_percent>5.8403548899447</sum_percent>
</day>
<day>
<datum>2015-09-14</datum>
<total_population>8669730</total_population>
<public_holiday_population>447366</public_holiday_population>
<public_holiday_percent>5.1600914907385</public_holiday_percent>
<public_holiday_description>Heiligkreuztag</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>447366</sum_population>
<sum_percent>5.1600914907385</sum_percent>
</day>
<day>
<datum>2015-09-21</datum>
<total_population>8669730</total_population>
<public_holiday_population>1033118</public_holiday_population>
<public_holiday_percent>11.91638032557</public_holiday_percent>
<public_holiday_description>Thuner Ausschiesset</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>1033118</sum_population>
<sum_percent>11.91638032557</sum_percent>
</day>
<day>
<datum>2015-11-01</datum>
<total_population>8669730</total_population>
<public_holiday_population>3959170</public_holiday_population>
<public_holiday_percent>45.66658938629</public_holiday_percent>
<public_holiday_description>Reformationssonntag Schweiz</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>3959170</sum_population>
<sum_percent>45.66658938629</sum_percent>
</day>
<day>
<datum>2015-12-08</datum>
<total_population>8669730</total_population>
<public_holiday_population>1937868</public_holiday_population>
<public_holiday_percent>22.35211477174</public_holiday_percent>
<public_holiday_description>Mariä Empfängnis</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>1937868</sum_population>
<sum_percent>22.35211477174</sum_percent>
</day>
<day>
<datum>2015-12-25</datum>
<total_population>8669730</total_population>
<public_holiday_population>8669730</public_holiday_population>
<public_holiday_percent>100</public_holiday_percent>
<public_holiday_description>Weihnachten</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>8669730</sum_population>
<sum_percent>100</sum_percent>
</day>
<day>
<datum>2015-12-26</datum>
<total_population>8669730</total_population>
<public_holiday_population>6562253</public_holiday_population>
<public_holiday_percent>75.691549794515</public_holiday_percent>
<public_holiday_description>Stephanstag</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>6562253</sum_population>
<sum_percent>75.691549794515</sum_percent>
</day>
<day>
<datum>2015-12-31</datum>
<total_population>8669730</total_population>
<public_holiday_population>509784</public_holiday_population>
<public_holiday_percent>5.8800447072746</public_holiday_percent>
<public_holiday_description>Silvester</public_holiday_description>
<school_holiday_population>0</school_holiday_population>
<school_holiday_percent>0</school_holiday_percent>
<school_holiday_description></school_holiday_description>
<sum_population>509784</sum_population>
<sum_percent>5.8800447072746</sum_percent>
</day>
</events>
</location>
</results>
</fcal_api>

CSV

URL:
https://www.feiertagskalender.ch/api/Data/Aggreg/index.php?api_key=YOUR_API_KEY&iso=CH&year=2015&format=csv

Response from the API:

"location";"geoId";"iso";"iso-3166-2";"date";"total_population";"public_holiday_population";"public_holiday_percent";"public_holiday_description";"school_holiday_population";"school_holiday_percent";"school_holiday_description";"sum_population";"sum_percent"
"Schweiz";"3056";"CH";"";"2015-01-01";"8669730";"8669730";"100";"Neujahr";"0";"0";"";"8669730";"100"
"Schweiz";"3056";"CH";"";"2015-01-02";"8669730";"5433386";"62.670763680068";"Berchtoldstag";"0";"0";"";"5433386";"62.670763680068"
"Schweiz";"3056";"CH";"";"2015-01-06";"8669730";"568122";"6.552937634736";"Heilige drei Könige";"0";"0";"";"568122";"6.552937634736"
"Schweiz";"3056";"CH";"";"2015-02-16";"8669730";"487825";"5.6267611563451";"Fasnachtsmontag";"0";"0";"";"487825";"5.6267611563451"
"Schweiz";"3056";"CH";"";"2015-03-19";"8669730";"1014489";"11.701506275282";"St. Josef";"0";"0";"";"1014489";"11.701506275282"
"Schweiz";"3056";"CH";"";"2015-04-03";"8669730";"7970642";"91.936450154734";"Karfreitag";"0";"0";"";"7970642";"91.936450154734"
"Schweiz";"3056";"CH";"";"2015-04-05";"8669730";"8669730";"100";"Ostern";"0";"0";"";"8669730";"100"
"Schweiz";"3056";"CH";"";"2015-04-06";"8669730";"8669730";"100";"Ostermontag";"0";"0";"";"8669730";"100"
"Schweiz";"3056";"CH";"";"2015-05-01";"8669730";"3293934";"37.993501527729";"Heiliger Sigismund";"0";"0";"";"3293934";"37.993501527729"
"Schweiz";"3056";"CH";"";"2015-05-14";"8669730";"8669730";"100";"Auffahrt";"0";"0";"";"8669730";"100"
"Schweiz";"3056";"CH";"";"2015-05-24";"8669730";"8669730";"100";"Pfingsten";"0";"0";"";"8669730";"100"
"Schweiz";"3056";"CH";"";"2015-05-25";"8669730";"8669730";"100";"Pfingstmontag";"0";"0";"";"8669730";"100"
"Schweiz";"3056";"CH";"";"2015-06-04";"8669730";"2574694";"29.697510764464";"Fronleichnam";"0";"0";"";"2574694";"29.697510764464"
"Schweiz";"3056";"CH";"";"2015-08-01";"8669730";"8669730";"100";"Nationalfeiertag Schweiz";"0";"0";"";"8669730";"100"
"Schweiz";"3056";"CH";"";"2015-08-15";"8669730";"2396949";"27.6473315778";"Mariä Himmelfahrt";"0";"0";"";"2396949";"27.6473315778"
"Schweiz";"3056";"CH";"";"2015-09-10";"8669730";"506343";"5.8403548899447";"Genfer Bettag";"0";"0";"";"506343";"5.8403548899447"
"Schweiz";"3056";"CH";"";"2015-09-14";"8669730";"447366";"5.1600914907385";"Heiligkreuztag";"0";"0";"";"447366";"5.1600914907385"
"Schweiz";"3056";"CH";"";"2015-09-21";"8669730";"1033118";"11.91638032557";"Thuner Ausschiesset";"0";"0";"";"1033118";"11.91638032557"
"Schweiz";"3056";"CH";"";"2015-11-01";"8669730";"3959170";"45.66658938629";"Reformationssonntag Schweiz";"0";"0";"";"3959170";"45.66658938629"
"Schweiz";"3056";"CH";"";"2015-12-08";"8669730";"1937868";"22.35211477174";"Mariä Empfängnis";"0";"0";"";"1937868";"22.35211477174"
"Schweiz";"3056";"CH";"";"2015-12-25";"8669730";"8669730";"100";"Weihnachten";"0";"0";"";"8669730";"100"
"Schweiz";"3056";"CH";"";"2015-12-26";"8669730";"6562253";"75.691549794515";"Stephanstag";"0";"0";"";"6562253";"75.691549794515"
"Schweiz";"3056";"CH";"";"2015-12-31";"8669730";"509784";"5.8800447072746";"Silvester";"0";"0";"";"509784";"5.8800447072746"

Error messages

Output location Error message Explanation
results: status:
results: status: description not subscribed You have not subscribed to the desired data.
results: status: description unknown location Das angeforderte ISO-Länderkürzel ist nicht bekannt.
Prüfen Sie bitte den Parameter iso
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.
© 2003 - 2025 psc Peter Schütz Informatik Dienstleistungen, CH-Arch