API documentation

Annual data

API: Data/Country/CH/PLZ

Get public holidays and school holidays for a whole year for all postcodes in Switzerland.

Function

This API determines for all **postcodes in Switzerland** on which days of the year an official public holiday or school holidays take place. The data also contains the FSO municipality number.

⚠ **Attention:** Some postcodes are assigned to several municipalities, e.g. 91.8% of postcode 1033 is assigned to Cheseaux-sur-Lausanne, 7.8% to Lausanne and 0.4% to Crissier. Only the values for the municipality with the largest share are included in the data.

The required parameter is `api_key`. The parameter `year` 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

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/Country/CH/PLZ/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
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

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/Country/CH/PLZ
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
  year       Year of the data in the output 2015
  class       Class of the query (concerns the scope of the data) 4
  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
results status description     Output status. For variants, see the Error messages ok
  locations location PLZ   Swiss postcode 1000
      description   Designation of the geographical unit Lausanne
      type   Designation of the type of geographical unit Commune
      geoId   Geo-ID of the geographical unit. 2425
      bfsNr   FSO community number 5586
      iso   ISO country code, 2 digits CH
      iso-3166-2   Region code according to ISO 3166-2 CH-VD
      note   Special notes
      events   The calendar events  
        description Designation of the public holiday, or school holidays New Year´s Day
        id Unique ID of the event.
Public holidays have the same ID every year.
School holidays all have their own IDs.
1
        dateStart Date Start of the event 01.01.2015
        dateEnd Date end of the event 01.01.2015
        class Class of the event:

0 = School holidays
1 = official holiday
2 = Public holiday on a par with Sundays
3 = half-holiday (normally starting from noon)
4 = legally not recognized holiday (shops, schools, administrations mostly closed), bank holiday; for the purposes of the European Convention on the Calculation of Time Limits, this day is treated as a public holiday (Art. 5).
5 = event day
# = partially valid
2
        percent Size of affected residents / school classes in percent 100
        prov Flag for provisionally set data

0 = definitely
1 = provisional
0
        note special notes  

Examples (JSON / XML / CSV)

JSON

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

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": "Data/Country/CH/PLZ",
    "apiStatus": {
        "description": "active"
    },
    "date": "2025-02-27",
    "request": {
        "iso": "CH",
        "year": 2022,
        "class": "4",
        "charset": "utf-8",
        "format": "json",
        "date_format": "Y-m-d",
        "hl": "de"
    },
    "results": {
        "status": {
            "description": "ok"
        },
        "locations": [
            {
                "plz": "1000",
                "description": "Lausanne",
                "type": "Gemeinde",
                "geoId": "2425",
                "bfsNr": "5586",
                "iso": "CH",
                "iso-3166-2": "CH-VD",
                "note": "",
                "events": [
                    {
                        "description": "Neujahr",
                        "id": "1",
                        "dateStart": "2022-01-01",
                        "dateEnd": "2022-01-01",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Berchtoldstag",
                        "id": "3",
                        "dateStart": "2022-01-02",
                        "dateEnd": "2022-01-02",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Karfreitag",
                        "id": "17",
                        "dateStart": "2022-04-15",
                        "dateEnd": "2022-04-15",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Ostern",
                        "id": "18",
                        "dateStart": "2022-04-17",
                        "dateEnd": "2022-04-17",
                        "class": "4",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Ostermontag",
                        "id": "19",
                        "dateStart": "2022-04-18",
                        "dateEnd": "2022-04-18",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Auffahrt",
                        "id": "31",
                        "dateStart": "2022-05-26",
                        "dateEnd": "2022-05-26",
                        "class": "2",
                        "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": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Nationalfeiertag Schweiz",
                        "id": "12",
                        "dateStart": "2022-08-01",
                        "dateEnd": "2022-08-01",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Bettagsmontag",
                        "id": "45",
                        "dateStart": "2022-09-19",
                        "dateEnd": "2022-09-19",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Weihnachten",
                        "id": "23",
                        "dateStart": "2022-12-25",
                        "dateEnd": "2022-12-25",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Winterferien",
                        "id": "705117",
                        "dateStart": "2021-12-24",
                        "dateEnd": "2022-01-09",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Sportferien",
                        "id": "705118",
                        "dateStart": "2022-02-19",
                        "dateEnd": "2022-02-27",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Osterferien",
                        "id": "705119",
                        "dateStart": "2022-04-15",
                        "dateEnd": "2022-05-01",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Auffahrtsferien",
                        "id": "705120",
                        "dateStart": "2022-05-26",
                        "dateEnd": "2022-05-29",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Pfingstmontag",
                        "id": "705121",
                        "dateStart": "2022-06-06",
                        "dateEnd": "2022-06-06",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Sommerferien",
                        "id": "705122",
                        "dateStart": "2022-07-02",
                        "dateEnd": "2022-08-21",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Bettagsmontag",
                        "id": "705123",
                        "dateStart": "2022-09-19",
                        "dateEnd": "2022-09-19",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Herbstferien",
                        "id": "705124",
                        "dateStart": "2022-10-15",
                        "dateEnd": "2022-10-30",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Winterferien",
                        "id": "705125",
                        "dateStart": "2022-12-24",
                        "dateEnd": "2023-01-08",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    }
                ]
            },
            {
                "plz": "1001",
                "description": "Lausanne",
                "type": "Gemeinde",
                "geoId": "2425",
                "bfsNr": "5586",
                "iso": "CH",
                "iso-3166-2": "CH-VD",
                "note": "",
                "events": [
                    {
                        "description": "Neujahr",
                        "id": "1",
                        "dateStart": "2022-01-01",
                        "dateEnd": "2022-01-01",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Berchtoldstag",
                        "id": "3",
                        "dateStart": "2022-01-02",
                        "dateEnd": "2022-01-02",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Karfreitag",
                        "id": "17",
                        "dateStart": "2022-04-15",
                        "dateEnd": "2022-04-15",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Ostern",
                        "id": "18",
                        "dateStart": "2022-04-17",
                        "dateEnd": "2022-04-17",
                        "class": "4",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Ostermontag",
                        "id": "19",
                        "dateStart": "2022-04-18",
                        "dateEnd": "2022-04-18",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Auffahrt",
                        "id": "31",
                        "dateStart": "2022-05-26",
                        "dateEnd": "2022-05-26",
                        "class": "2",
                        "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": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Nationalfeiertag Schweiz",
                        "id": "12",
                        "dateStart": "2022-08-01",
                        "dateEnd": "2022-08-01",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Bettagsmontag",
                        "id": "45",
                        "dateStart": "2022-09-19",
                        "dateEnd": "2022-09-19",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Weihnachten",
                        "id": "23",
                        "dateStart": "2022-12-25",
                        "dateEnd": "2022-12-25",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Winterferien",
                        "id": "705117",
                        "dateStart": "2021-12-24",
                        "dateEnd": "2022-01-09",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Sportferien",
                        "id": "705118",
                        "dateStart": "2022-02-19",
                        "dateEnd": "2022-02-27",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Osterferien",
                        "id": "705119",
                        "dateStart": "2022-04-15",
                        "dateEnd": "2022-05-01",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Auffahrtsferien",
                        "id": "705120",
                        "dateStart": "2022-05-26",
                        "dateEnd": "2022-05-29",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Pfingstmontag",
                        "id": "705121",
                        "dateStart": "2022-06-06",
                        "dateEnd": "2022-06-06",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Sommerferien",
                        "id": "705122",
                        "dateStart": "2022-07-02",
                        "dateEnd": "2022-08-21",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Bettagsmontag",
                        "id": "705123",
                        "dateStart": "2022-09-19",
                        "dateEnd": "2022-09-19",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Herbstferien",
                        "id": "705124",
                        "dateStart": "2022-10-15",
                        "dateEnd": "2022-10-30",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Winterferien",
                        "id": "705125",
                        "dateStart": "2022-12-24",
                        "dateEnd": "2023-01-08",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    }
                ]
            },
            {
                "plz": "1002",
                "description": "Lausanne",
                "type": "Gemeinde",
                "geoId": "2425",
                "bfsNr": "5586",
                "iso": "CH",
                "iso-3166-2": "CH-VD",
                "note": "",
                "events": [
                    {
                        "description": "Neujahr",
                        "id": "1",
                        "dateStart": "2022-01-01",
                        "dateEnd": "2022-01-01",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Berchtoldstag",
                        "id": "3",
                        "dateStart": "2022-01-02",
                        "dateEnd": "2022-01-02",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Karfreitag",
                        "id": "17",
                        "dateStart": "2022-04-15",
                        "dateEnd": "2022-04-15",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Ostern",
                        "id": "18",
                        "dateStart": "2022-04-17",
                        "dateEnd": "2022-04-17",
                        "class": "4",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Ostermontag",
                        "id": "19",
                        "dateStart": "2022-04-18",
                        "dateEnd": "2022-04-18",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Auffahrt",
                        "id": "31",
                        "dateStart": "2022-05-26",
                        "dateEnd": "2022-05-26",
                        "class": "2",
                        "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": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Nationalfeiertag Schweiz",
                        "id": "12",
                        "dateStart": "2022-08-01",
                        "dateEnd": "2022-08-01",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Bettagsmontag",
                        "id": "45",
                        "dateStart": "2022-09-19",
                        "dateEnd": "2022-09-19",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Weihnachten",
                        "id": "23",
                        "dateStart": "2022-12-25",
                        "dateEnd": "2022-12-25",
                        "class": "2",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Winterferien",
                        "id": "705117",
                        "dateStart": "2021-12-24",
                        "dateEnd": "2022-01-09",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Sportferien",
                        "id": "705118",
                        "dateStart": "2022-02-19",
                        "dateEnd": "2022-02-27",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Osterferien",
                        "id": "705119",
                        "dateStart": "2022-04-15",
                        "dateEnd": "2022-05-01",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Auffahrtsferien",
                        "id": "705120",
                        "dateStart": "2022-05-26",
                        "dateEnd": "2022-05-29",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Pfingstmontag",
                        "id": "705121",
                        "dateStart": "2022-06-06",
                        "dateEnd": "2022-06-06",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Sommerferien",
                        "id": "705122",
                        "dateStart": "2022-07-02",
                        "dateEnd": "2022-08-21",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Bettagsmontag",
                        "id": "705123",
                        "dateStart": "2022-09-19",
                        "dateEnd": "2022-09-19",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Herbstferien",
                        "id": "705124",
                        "dateStart": "2022-10-15",
                        "dateEnd": "2022-10-30",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    },
                    {
                        "description": "Winterferien",
                        "id": "705125",
                        "dateStart": "2022-12-24",
                        "dateEnd": "2023-01-08",
                        "class": "0",
                        "percent": "100",
                        "prov": "0",
                        "note": null
                    }
                ]
            }
        ]
    }
}

XML

URL:
https://www.feiertagskalender.ch/api/Data/Country/CH/PLZ/index.php?api_key=YOUR_API_KEY&year=2022&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>Data/Country/CH/PLZ</apiName>
<date>2025-02-27</date>
<request>
<iso>CH</iso>
<year>2022</year>
<class>4</class>
<charset>utf-8</charset>
<format>xml</format>
<date_format>Y-m-d</date_format>
<hl>de</hl>
</request>
<results>
<status>
<description>ok</description>
</status>
<locations>
<location>
<plz>1000</plz>
<description>Lausanne</description>
<type>Gemeinde</type>
<geoId>2425</geoId>
<bfsNr>5586</bfsNr>
<iso>CH</iso>
<iso-3166-2>CH-VD</iso-3166-2>
<note></note>
<events>
<event>
<description>Neujahr</description>
<id>1</id>
<dateStart>2022-01-01</dateStart>
<dateEnd>2022-01-01</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Berchtoldstag</description>
<id>3</id>
<dateStart>2022-01-02</dateStart>
<dateEnd>2022-01-02</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Karfreitag</description>
<id>17</id>
<dateStart>2022-04-15</dateStart>
<dateEnd>2022-04-15</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Ostern</description>
<id>18</id>
<dateStart>2022-04-17</dateStart>
<dateEnd>2022-04-17</dateEnd>
<class>4</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Ostermontag</description>
<id>19</id>
<dateStart>2022-04-18</dateStart>
<dateEnd>2022-04-18</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Auffahrt</description>
<id>31</id>
<dateStart>2022-05-26</dateStart>
<dateEnd>2022-05-26</dateEnd>
<class>2</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>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Nationalfeiertag Schweiz</description>
<id>12</id>
<dateStart>2022-08-01</dateStart>
<dateEnd>2022-08-01</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Bettagsmontag</description>
<id>45</id>
<dateStart>2022-09-19</dateStart>
<dateEnd>2022-09-19</dateEnd>
<class>2</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>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Winterferien</description>
<id>705117</id>
<dateStart>2021-12-24</dateStart>
<dateEnd>2022-01-09</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Sportferien</description>
<id>705118</id>
<dateStart>2022-02-19</dateStart>
<dateEnd>2022-02-27</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Osterferien</description>
<id>705119</id>
<dateStart>2022-04-15</dateStart>
<dateEnd>2022-05-01</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Auffahrtsferien</description>
<id>705120</id>
<dateStart>2022-05-26</dateStart>
<dateEnd>2022-05-29</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Pfingstmontag</description>
<id>705121</id>
<dateStart>2022-06-06</dateStart>
<dateEnd>2022-06-06</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Sommerferien</description>
<id>705122</id>
<dateStart>2022-07-02</dateStart>
<dateEnd>2022-08-21</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Bettagsmontag</description>
<id>705123</id>
<dateStart>2022-09-19</dateStart>
<dateEnd>2022-09-19</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Herbstferien</description>
<id>705124</id>
<dateStart>2022-10-15</dateStart>
<dateEnd>2022-10-30</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Winterferien</description>
<id>705125</id>
<dateStart>2022-12-24</dateStart>
<dateEnd>2023-01-08</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
</events>
</location>
<location>
<plz>1001</plz>
<description>Lausanne</description>
<type>Gemeinde</type>
<geoId>2425</geoId>
<bfsNr>5586</bfsNr>
<iso>CH</iso>
<iso-3166-2>CH-VD</iso-3166-2>
<note></note>
<events>
<event>
<description>Neujahr</description>
<id>1</id>
<dateStart>2022-01-01</dateStart>
<dateEnd>2022-01-01</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Berchtoldstag</description>
<id>3</id>
<dateStart>2022-01-02</dateStart>
<dateEnd>2022-01-02</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Karfreitag</description>
<id>17</id>
<dateStart>2022-04-15</dateStart>
<dateEnd>2022-04-15</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Ostern</description>
<id>18</id>
<dateStart>2022-04-17</dateStart>
<dateEnd>2022-04-17</dateEnd>
<class>4</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Ostermontag</description>
<id>19</id>
<dateStart>2022-04-18</dateStart>
<dateEnd>2022-04-18</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Auffahrt</description>
<id>31</id>
<dateStart>2022-05-26</dateStart>
<dateEnd>2022-05-26</dateEnd>
<class>2</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>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Nationalfeiertag Schweiz</description>
<id>12</id>
<dateStart>2022-08-01</dateStart>
<dateEnd>2022-08-01</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Bettagsmontag</description>
<id>45</id>
<dateStart>2022-09-19</dateStart>
<dateEnd>2022-09-19</dateEnd>
<class>2</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>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Winterferien</description>
<id>705117</id>
<dateStart>2021-12-24</dateStart>
<dateEnd>2022-01-09</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Sportferien</description>
<id>705118</id>
<dateStart>2022-02-19</dateStart>
<dateEnd>2022-02-27</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Osterferien</description>
<id>705119</id>
<dateStart>2022-04-15</dateStart>
<dateEnd>2022-05-01</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Auffahrtsferien</description>
<id>705120</id>
<dateStart>2022-05-26</dateStart>
<dateEnd>2022-05-29</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Pfingstmontag</description>
<id>705121</id>
<dateStart>2022-06-06</dateStart>
<dateEnd>2022-06-06</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Sommerferien</description>
<id>705122</id>
<dateStart>2022-07-02</dateStart>
<dateEnd>2022-08-21</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Bettagsmontag</description>
<id>705123</id>
<dateStart>2022-09-19</dateStart>
<dateEnd>2022-09-19</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Herbstferien</description>
<id>705124</id>
<dateStart>2022-10-15</dateStart>
<dateEnd>2022-10-30</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Winterferien</description>
<id>705125</id>
<dateStart>2022-12-24</dateStart>
<dateEnd>2023-01-08</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
</events>
</location>
<location>
<plz>1002</plz>
<description>Lausanne</description>
<type>Gemeinde</type>
<geoId>2425</geoId>
<bfsNr>5586</bfsNr>
<iso>CH</iso>
<iso-3166-2>CH-VD</iso-3166-2>
<note></note>
<events>
<event>
<description>Neujahr</description>
<id>1</id>
<dateStart>2022-01-01</dateStart>
<dateEnd>2022-01-01</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Berchtoldstag</description>
<id>3</id>
<dateStart>2022-01-02</dateStart>
<dateEnd>2022-01-02</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Karfreitag</description>
<id>17</id>
<dateStart>2022-04-15</dateStart>
<dateEnd>2022-04-15</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Ostern</description>
<id>18</id>
<dateStart>2022-04-17</dateStart>
<dateEnd>2022-04-17</dateEnd>
<class>4</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Ostermontag</description>
<id>19</id>
<dateStart>2022-04-18</dateStart>
<dateEnd>2022-04-18</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Auffahrt</description>
<id>31</id>
<dateStart>2022-05-26</dateStart>
<dateEnd>2022-05-26</dateEnd>
<class>2</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>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Nationalfeiertag Schweiz</description>
<id>12</id>
<dateStart>2022-08-01</dateStart>
<dateEnd>2022-08-01</dateEnd>
<class>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Bettagsmontag</description>
<id>45</id>
<dateStart>2022-09-19</dateStart>
<dateEnd>2022-09-19</dateEnd>
<class>2</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>2</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Winterferien</description>
<id>705117</id>
<dateStart>2021-12-24</dateStart>
<dateEnd>2022-01-09</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Sportferien</description>
<id>705118</id>
<dateStart>2022-02-19</dateStart>
<dateEnd>2022-02-27</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Osterferien</description>
<id>705119</id>
<dateStart>2022-04-15</dateStart>
<dateEnd>2022-05-01</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Auffahrtsferien</description>
<id>705120</id>
<dateStart>2022-05-26</dateStart>
<dateEnd>2022-05-29</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Pfingstmontag</description>
<id>705121</id>
<dateStart>2022-06-06</dateStart>
<dateEnd>2022-06-06</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Sommerferien</description>
<id>705122</id>
<dateStart>2022-07-02</dateStart>
<dateEnd>2022-08-21</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Bettagsmontag</description>
<id>705123</id>
<dateStart>2022-09-19</dateStart>
<dateEnd>2022-09-19</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Herbstferien</description>
<id>705124</id>
<dateStart>2022-10-15</dateStart>
<dateEnd>2022-10-30</dateEnd>
<class>0</class>
<percent>100</percent>
<prov>0</prov>
<note></note>
</event>
<event>
<description>Winterferien</description>
<id>705125</id>
<dateStart>2022-12-24</dateStart>
<dateEnd>2023-01-08</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/CH/PLZ/index.php?api_key=YOUR_API_KEY&year=2022&format=csv

Response from the API:

"plz";"location";"geoId";"bfsNr";"iso";"iso_3166_2";"description";"id";"dateStart";"dateEnd";"class";"percent";"prov";"note"
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Neujahr";"1";"2022-01-01";"2022-01-01";"2";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Berchtoldstag";"3";"2022-01-02";"2022-01-02";"2";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Karfreitag";"17";"2022-04-15";"2022-04-15";"2";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Ostermontag";"19";"2022-04-18";"2022-04-18";"2";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Auffahrt";"31";"2022-05-26";"2022-05-26";"2";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Pfingsten";"30";"2022-06-05";"2022-06-05";"4";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Pfingstmontag";"35";"2022-06-06";"2022-06-06";"2";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Nationalfeiertag Schweiz";"12";"2022-08-01";"2022-08-01";"2";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Bettagsmontag";"45";"2022-09-19";"2022-09-19";"2";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Weihnachten";"23";"2022-12-25";"2022-12-25";"2";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Winterferien";"705117";"2021-12-24";"2022-01-09";"0";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Sportferien";"705118";"2022-02-19";"2022-02-27";"0";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Osterferien";"705119";"2022-04-15";"2022-05-01";"0";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Auffahrtsferien";"705120";"2022-05-26";"2022-05-29";"0";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Pfingstmontag";"705121";"2022-06-06";"2022-06-06";"0";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Sommerferien";"705122";"2022-07-02";"2022-08-21";"0";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Bettagsmontag";"705123";"2022-09-19";"2022-09-19";"0";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Herbstferien";"705124";"2022-10-15";"2022-10-30";"0";"100";"0";""
"1000";"Lausanne";"2425";"5586";"CH";"CH-VD";"Winterferien";"705125";"2022-12-24";"2023-01-08";"0";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Neujahr";"1";"2022-01-01";"2022-01-01";"2";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Berchtoldstag";"3";"2022-01-02";"2022-01-02";"2";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Karfreitag";"17";"2022-04-15";"2022-04-15";"2";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Ostermontag";"19";"2022-04-18";"2022-04-18";"2";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Auffahrt";"31";"2022-05-26";"2022-05-26";"2";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Pfingsten";"30";"2022-06-05";"2022-06-05";"4";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Pfingstmontag";"35";"2022-06-06";"2022-06-06";"2";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Nationalfeiertag Schweiz";"12";"2022-08-01";"2022-08-01";"2";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Bettagsmontag";"45";"2022-09-19";"2022-09-19";"2";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Weihnachten";"23";"2022-12-25";"2022-12-25";"2";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Winterferien";"705117";"2021-12-24";"2022-01-09";"0";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Sportferien";"705118";"2022-02-19";"2022-02-27";"0";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Osterferien";"705119";"2022-04-15";"2022-05-01";"0";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Auffahrtsferien";"705120";"2022-05-26";"2022-05-29";"0";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Pfingstmontag";"705121";"2022-06-06";"2022-06-06";"0";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Sommerferien";"705122";"2022-07-02";"2022-08-21";"0";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Bettagsmontag";"705123";"2022-09-19";"2022-09-19";"0";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Herbstferien";"705124";"2022-10-15";"2022-10-30";"0";"100";"0";""
"1001";"Lausanne";"2425";"5586";"CH";"CH-VD";"Winterferien";"705125";"2022-12-24";"2023-01-08";"0";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Neujahr";"1";"2022-01-01";"2022-01-01";"2";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Berchtoldstag";"3";"2022-01-02";"2022-01-02";"2";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Karfreitag";"17";"2022-04-15";"2022-04-15";"2";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Ostern";"18";"2022-04-17";"2022-04-17";"4";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Ostermontag";"19";"2022-04-18";"2022-04-18";"2";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Auffahrt";"31";"2022-05-26";"2022-05-26";"2";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Pfingsten";"30";"2022-06-05";"2022-06-05";"4";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Pfingstmontag";"35";"2022-06-06";"2022-06-06";"2";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Nationalfeiertag Schweiz";"12";"2022-08-01";"2022-08-01";"2";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Bettagsmontag";"45";"2022-09-19";"2022-09-19";"2";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Weihnachten";"23";"2022-12-25";"2022-12-25";"2";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Winterferien";"705117";"2021-12-24";"2022-01-09";"0";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Sportferien";"705118";"2022-02-19";"2022-02-27";"0";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Osterferien";"705119";"2022-04-15";"2022-05-01";"0";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Auffahrtsferien";"705120";"2022-05-26";"2022-05-29";"0";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Pfingstmontag";"705121";"2022-06-06";"2022-06-06";"0";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Sommerferien";"705122";"2022-07-02";"2022-08-21";"0";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Bettagsmontag";"705123";"2022-09-19";"2022-09-19";"0";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Herbstferien";"705124";"2022-10-15";"2022-10-30";"0";"100";"0";""
"1002";"Lausanne";"2425";"5586";"CH";"CH-VD";"Winterferien";"705125";"2022-12-24";"2023-01-08";"0";"100";"0";""

Error messages

Output location Error message Explanation
results: status:
results: status: description not subscribed You have not subscribed to the desired data.
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