{ "openapi": "3.0.0", "info": { "title": "Feiertagskalender API", "description": "This API determines on which days of the year an official public holiday or school holidays take place at a particular location. The required parameters are `api_key` and `bfs`. 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.

**CSV note:** The CSV output contains a flat table structure in which nested JSON\/XML elements are not mapped. Some data fields are not available in CSV format.", "version": "0.9.0" }, "servers": [ { "url": "https:\/\/feiertagskalender.ch\/api" } ], "paths": { "\/Data\/CH\/BFS\/index.php": { "get": { "tags": [ "Read out annual data for 1 location" ], "summary": "Get public holidays and school holidays for a whole year, based on a Swiss municipality number (BFS). (query parameter)", "description": "**Data\/CH\/BFS**
This API determines on which days of the year an official public holiday or school holidays take place at a particular location. The required parameters are `api_key` and `bfs`. 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.", "parameters": [ { "name": "api_key", "in": "query", "required": true, "description": "Your API Key", "schema": { "type": "string" } }, { "name": "bfs", "in": "query", "required": true, "description": "FSO community number", "schema": { "type": "integer", "minimum": 1, "maximum": 9999 } }, { "name": "year", "in": "query", "required": false, "description": "Year (2000 - 2050)", "schema": { "type": "integer", "minimum": 2000, "maximum": 2050 } }, { "name": "class", "in": "query", "required": false, "description": "Class type for filtering. Available values:\r\n- `0` = school holidays only\r\n- `3` = 0 + public holidays recognised by law\r\n- `4` = 0 + 3 + public and non-public holidays (religious, cultural) (default)\r\n- `5` = 0 + 3 + 4 + event days (e.g. Valentine's Day, Mother's Day, Advent)", "schema": { "type": "integer", "enum": [ 0, 3, 4, 5 ], "default": 4 } }, { "name": "charset", "in": "query", "required": false, "description": "The desired coding of the response", "schema": { "type": "string", "enum": [ "utf-8", "iso-8859-1" ], "default": "utf-8" } }, { "name": "format", "in": "query", "required": false, "description": "The desired output format", "schema": { "type": "string", "enum": [ "json", "xml", "csv" ], "default": "json" } }, { "name": "date_format", "in": "query", "required": false, "description": "The desired date format for the response. Default: `Y-m-d` (e.g., 2025-12-31)\r\n", "schema": { "type": "string", "enum": [ "Y-m-d", "d.m.Y", "dmY", "Ymd", "d.n.y", "j.n.y" ], "default": "Y-m-d" } }, { "name": "hl", "in": "query", "required": false, "description": "Desired language of the output", "schema": { "type": "string", "enum": [ "de", "en", "fr", "it" ], "default": "de" } } ], "responses": { "200": { "description": "Successful response with the query results. The CSV output contains a flat table structure in which nested JSON\/XML elements are not mapped. Please note that some data fields are not available in CSV format. \n\n**JSON-Request:**\n`https:\/\/feiertagskalender.ch\/api\/Data\/CH\/BFS\/index.php?api_key=YOUR_API_KEY&bfs=261&year=2022`\n\n**XML-Request:**\n`https:\/\/feiertagskalender.ch\/api\/Data\/CH\/BFS\/index.php?api_key=YOUR_API_KEY&bfs=261&year=2022&format=XML`\n\n**CSV-Request:**\n`https:\/\/feiertagskalender.ch\/api\/Data\/CH\/BFS\/index.php?api_key=YOUR_API_KEY&bfs=261&year=2022&format=CSV`\n\n", "content": { "application\/json": { "example": { "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\/CH\/BFS", "apiStatus": { "description": "active" }, "date": "2025-02-27", "request": { "bfs": "261", "year": 2022, "class": "4", "charset": "utf-8", "format": "json", "date_format": "Y-m-d", "hl": "de" }, "results": { "status": { "description": "ok" }, "location": { "description": "Zürich", "type": "Stadt", "geoId": "3055", "iso": "CH", "iso-3166-2": "CH-ZH", "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": "4", "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": "Sechseläuten", "id": "20", "dateStart": "2022-04-25", "dateEnd": "2022-04-25", "class": "4", "percent": "100", "prov": "0", "note": null }, { "description": "Tag der Arbeit", "id": "22", "dateStart": "2022-05-01", "dateEnd": "2022-05-01", "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": "Knabenschiessen", "id": "60", "dateStart": "2022-09-12", "dateEnd": "2022-09-12", "class": "4", "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": "Stephanstag", "id": "37", "dateStart": "2022-12-26", "dateEnd": "2022-12-26", "class": "2", "percent": "100", "prov": "0", "note": null }, { "description": "Weihnachtsferien", "id": "629306", "dateStart": "2021-12-20", "dateEnd": "2022-01-01", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Sportferien", "id": "629307", "dateStart": "2022-02-14", "dateEnd": "2022-02-25", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Osterferien", "id": "629308", "dateStart": "2022-04-14", "dateEnd": "2022-04-18", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Frühlingsferien", "id": "629309", "dateStart": "2022-04-18", "dateEnd": "2022-04-29", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Auffahrtsferien", "id": "629310", "dateStart": "2022-05-26", "dateEnd": "2022-05-29", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Pfingstmontag", "id": "629311", "dateStart": "2022-06-06", "dateEnd": "2022-06-06", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Sommerferien", "id": "629312", "dateStart": "2022-07-18", "dateEnd": "2022-08-19", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Knabenschiessen", "id": "629313", "dateStart": "2022-09-12", "dateEnd": "2022-09-12", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Herbstferien", "id": "629314", "dateStart": "2022-10-10", "dateEnd": "2022-10-21", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Weihnachtsferien", "id": "629315", "dateStart": "2022-12-26", "dateEnd": "2023-01-06", "class": "0", "percent": "100", "prov": "0", "note": null } ] } } } }, "application\/xml": { "schema": { "type": "object", "xml": { "name": "fcal_api" } }, "example": "\r\nfcal API 2.02<\/interface>\r\n\r\nhttps:\/\/feiertagskalender.ch<\/href>\r\nfeiertagskalender.ch<\/description>\r\n<\/source>\r\n\r\nhttps:\/\/psc.ch<\/href>\r\npsc Peter Schuetz Informatik-Dienstleistungen, CH Bern<\/description>\r\n<\/copyright>\r\n\r\nactive<\/description>\r\n<\/apiStatus>\r\nData\/CH\/BFS<\/apiName>\r\n2025-02-27<\/date>\r\n\r\n261<\/bfs>\r\n2022<\/year>\r\n4<\/class>\r\nutf-8<\/charset>\r\nxml<\/format>\r\nY-m-d<\/date_format>\r\nde<\/hl>\r\n<\/request>\r\n\r\n\r\nok<\/description>\r\n<\/status>\r\n\r\nZürich<\/description>\r\nStadt<\/type>\r\n3055<\/geoId>\r\nCH<\/iso>\r\nCH-ZH<\/iso-3166-2>\r\n<\/note>\r\n\r\n\r\nNeujahr<\/description>\r\n1<\/id>\r\n2022-01-01<\/dateStart>\r\n2022-01-01<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nBerchtoldstag<\/description>\r\n3<\/id>\r\n2022-01-02<\/dateStart>\r\n2022-01-02<\/dateEnd>\r\n4<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nKarfreitag<\/description>\r\n17<\/id>\r\n2022-04-15<\/dateStart>\r\n2022-04-15<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nOstern<\/description>\r\n18<\/id>\r\n2022-04-17<\/dateStart>\r\n2022-04-17<\/dateEnd>\r\n4<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nOstermontag<\/description>\r\n19<\/id>\r\n2022-04-18<\/dateStart>\r\n2022-04-18<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nSechseläuten<\/description>\r\n20<\/id>\r\n2022-04-25<\/dateStart>\r\n2022-04-25<\/dateEnd>\r\n4<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nTag der Arbeit<\/description>\r\n22<\/id>\r\n2022-05-01<\/dateStart>\r\n2022-05-01<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nAuffahrt<\/description>\r\n31<\/id>\r\n2022-05-26<\/dateStart>\r\n2022-05-26<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nPfingsten<\/description>\r\n30<\/id>\r\n2022-06-05<\/dateStart>\r\n2022-06-05<\/dateEnd>\r\n4<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nPfingstmontag<\/description>\r\n35<\/id>\r\n2022-06-06<\/dateStart>\r\n2022-06-06<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nNationalfeiertag Schweiz<\/description>\r\n12<\/id>\r\n2022-08-01<\/dateStart>\r\n2022-08-01<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nKnabenschiessen<\/description>\r\n60<\/id>\r\n2022-09-12<\/dateStart>\r\n2022-09-12<\/dateEnd>\r\n4<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nWeihnachten<\/description>\r\n23<\/id>\r\n2022-12-25<\/dateStart>\r\n2022-12-25<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nStephanstag<\/description>\r\n37<\/id>\r\n2022-12-26<\/dateStart>\r\n2022-12-26<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nWeihnachtsferien<\/description>\r\n629306<\/id>\r\n2021-12-20<\/dateStart>\r\n2022-01-01<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nSportferien<\/description>\r\n629307<\/id>\r\n2022-02-14<\/dateStart>\r\n2022-02-25<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nOsterferien<\/description>\r\n629308<\/id>\r\n2022-04-14<\/dateStart>\r\n2022-04-18<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nFrühlingsferien<\/description>\r\n629309<\/id>\r\n2022-04-18<\/dateStart>\r\n2022-04-29<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nAuffahrtsferien<\/description>\r\n629310<\/id>\r\n2022-05-26<\/dateStart>\r\n2022-05-29<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nPfingstmontag<\/description>\r\n629311<\/id>\r\n2022-06-06<\/dateStart>\r\n2022-06-06<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nSommerferien<\/description>\r\n629312<\/id>\r\n2022-07-18<\/dateStart>\r\n2022-08-19<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nKnabenschiessen<\/description>\r\n629313<\/id>\r\n2022-09-12<\/dateStart>\r\n2022-09-12<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nHerbstferien<\/description>\r\n629314<\/id>\r\n2022-10-10<\/dateStart>\r\n2022-10-21<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nWeihnachtsferien<\/description>\r\n629315<\/id>\r\n2022-12-26<\/dateStart>\r\n2023-01-06<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n<\/events>\r\n<\/location>\r\n<\/results>\r\n<\/fcal_api>" }, "application\/csv": { "example": "\"location\";\"bfs\";\"description\";\"id\";\"dateStart\";\"dateEnd\";\"class\";\"percent\";\"prov\";\"note\"\r\n\"Zürich\";\"261\";\"Neujahr\";\"1\";\"2022-01-01\";\"2022-01-01\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Berchtoldstag\";\"3\";\"2022-01-02\";\"2022-01-02\";\"4\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Karfreitag\";\"17\";\"2022-04-15\";\"2022-04-15\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Ostern\";\"18\";\"2022-04-17\";\"2022-04-17\";\"4\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Ostermontag\";\"19\";\"2022-04-18\";\"2022-04-18\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Sechseläuten\";\"20\";\"2022-04-25\";\"2022-04-25\";\"4\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Tag der Arbeit\";\"22\";\"2022-05-01\";\"2022-05-01\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Auffahrt\";\"31\";\"2022-05-26\";\"2022-05-26\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Pfingsten\";\"30\";\"2022-06-05\";\"2022-06-05\";\"4\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Pfingstmontag\";\"35\";\"2022-06-06\";\"2022-06-06\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Nationalfeiertag Schweiz\";\"12\";\"2022-08-01\";\"2022-08-01\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Knabenschiessen\";\"60\";\"2022-09-12\";\"2022-09-12\";\"4\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Weihnachten\";\"23\";\"2022-12-25\";\"2022-12-25\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Stephanstag\";\"37\";\"2022-12-26\";\"2022-12-26\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Weihnachtsferien\";\"629306\";\"2021-12-20\";\"2022-01-01\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Sportferien\";\"629307\";\"2022-02-14\";\"2022-02-25\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Osterferien\";\"629308\";\"2022-04-14\";\"2022-04-18\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Frühlingsferien\";\"629309\";\"2022-04-18\";\"2022-04-29\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Auffahrtsferien\";\"629310\";\"2022-05-26\";\"2022-05-29\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Pfingstmontag\";\"629311\";\"2022-06-06\";\"2022-06-06\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Sommerferien\";\"629312\";\"2022-07-18\";\"2022-08-19\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Knabenschiessen\";\"629313\";\"2022-09-12\";\"2022-09-12\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Herbstferien\";\"629314\";\"2022-10-10\";\"2022-10-21\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Weihnachtsferien\";\"629315\";\"2022-12-26\";\"2023-01-06\";\"0\";\"100\";\"0\";\"\"" } } }, "400": { "description": "Incorrect request - missing or invalid parameters.", "content": { "application\/json": { "examples": { "not subscribed": { "summary": "You have not subscribed to the desired data.", "value": { "results": { "status": { "description": "not subscribed" } } } }, "unknown_location": { "summary": "The requested municipality number is not known.", "value": { "results": { "status": { "description": "unknown location" } } } } } } } }, "403": { "description": "Access denied - Invalid API key.", "content": { "application\/json": { "examples": { "invalid_key": { "summary": "Invalid API key.", "value": { "apiStatus": { "description": "invalid key" } } }, "invalid_usage": { "summary": "The use of this API is not enabled for this user.", "value": { "apiStatus": { "description": "invalid usage" } } }, "invalid_referer": { "summary": "Invalid access. Links from web pages (front-ends) are not allowed.", "value": { "apiStatus": { "description": "invalid referer" } } }, "inactive": { "summary": "The API has not yet been activated for use.", "value": { "apiStatus": { "description": "inactive" } } }, "expired": { "summary": "The period of use according to the contract has expired.", "value": { "apiStatus": { "description": "expired" } } } } } } }, "500": { "description": "Interner Serverfehler – ein unerwarteter Fehler ist aufgetreten.", "content": { "application\/json": { "example": { "error": { "code": 500, "message": "Interner Serverfehler. Bitte versuchen Sie es später erneut." } } } } } } }, "post": { "tags": [ "Read out annual data for 1 location" ], "summary": "Get public holidays and school holidays for a whole year, based on a Swiss municipality number (BFS). ((JSON request)", "description": "**Data\/CH\/BFS**
This API determines on which days of the year an official public holiday or school holidays take place at a particular location. The required parameters are `api_key` and `bfs`. The `year` parameter is optional - if it is not specified, the current year is automatically used. The output can also be configured using additional parameters. The parameters are transferred as JSON in the request body. Alternatively, authorisation can also take place in the header. ", "requestBody": { "required": true, "content": { "application\/json": { "schema": { "type": "object", "properties": { "api_key": { "type": "string" }, "bfs": { "type": "integer", "minimum": 1, "maximum": 9999 }, "year": { "type": "integer", "minimum": 2000, "maximum": 2050 }, "class": { "type": "integer", "enum": [ 0, 3, 4, 5 ], "default": 4 }, "charset": { "type": "string", "enum": [ "utf-8", "iso-8859-1" ], "default": "utf-8" }, "format": { "type": "string", "enum": [ "json", "xml", "csv" ], "default": "json" }, "date_format": { "type": "string", "enum": [ "Y-m-d", "d.m.Y", "dmY", "Ymd", "d.n.y", "j.n.y" ], "default": "Y-m-d" }, "hl": { "type": "string", "enum": [ "de", "fr", "it", "en" ], "default": "de" } }, "required": [ "api_key", "bfs" ] }, "example": { "api_key": "YOUR_API_KEY", "bfs": 261, "year": 2022, "class": 4, "charset": "utf-8", "format": "json", "date_format": "Y-m-d", "hl": "de" } } } }, "responses": { "200": { "description": "Successful response with the query results. The CSV output contains a flat table structure in which nested JSON\/XML elements are not mapped. Please note that some data fields are not available in CSV format.", "content": { "application\/json": { "example": { "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\/CH\/BFS", "apiStatus": { "description": "active" }, "date": "2025-02-27", "request": { "bfs": "261", "year": 2022, "class": "4", "charset": "utf-8", "format": "json", "date_format": "Y-m-d", "hl": "de" }, "results": { "status": { "description": "ok" }, "location": { "description": "Zürich", "type": "Stadt", "geoId": "3055", "iso": "CH", "iso-3166-2": "CH-ZH", "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": "4", "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": "Sechseläuten", "id": "20", "dateStart": "2022-04-25", "dateEnd": "2022-04-25", "class": "4", "percent": "100", "prov": "0", "note": null }, { "description": "Tag der Arbeit", "id": "22", "dateStart": "2022-05-01", "dateEnd": "2022-05-01", "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": "Knabenschiessen", "id": "60", "dateStart": "2022-09-12", "dateEnd": "2022-09-12", "class": "4", "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": "Stephanstag", "id": "37", "dateStart": "2022-12-26", "dateEnd": "2022-12-26", "class": "2", "percent": "100", "prov": "0", "note": null }, { "description": "Weihnachtsferien", "id": "629306", "dateStart": "2021-12-20", "dateEnd": "2022-01-01", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Sportferien", "id": "629307", "dateStart": "2022-02-14", "dateEnd": "2022-02-25", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Osterferien", "id": "629308", "dateStart": "2022-04-14", "dateEnd": "2022-04-18", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Frühlingsferien", "id": "629309", "dateStart": "2022-04-18", "dateEnd": "2022-04-29", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Auffahrtsferien", "id": "629310", "dateStart": "2022-05-26", "dateEnd": "2022-05-29", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Pfingstmontag", "id": "629311", "dateStart": "2022-06-06", "dateEnd": "2022-06-06", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Sommerferien", "id": "629312", "dateStart": "2022-07-18", "dateEnd": "2022-08-19", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Knabenschiessen", "id": "629313", "dateStart": "2022-09-12", "dateEnd": "2022-09-12", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Herbstferien", "id": "629314", "dateStart": "2022-10-10", "dateEnd": "2022-10-21", "class": "0", "percent": "100", "prov": "0", "note": null }, { "description": "Weihnachtsferien", "id": "629315", "dateStart": "2022-12-26", "dateEnd": "2023-01-06", "class": "0", "percent": "100", "prov": "0", "note": null } ] } } } }, "application\/xml": { "schema": { "type": "object", "xml": { "name": "fcal_api" } }, "example": "\r\nfcal API 2.02<\/interface>\r\n\r\nhttps:\/\/feiertagskalender.ch<\/href>\r\nfeiertagskalender.ch<\/description>\r\n<\/source>\r\n\r\nhttps:\/\/psc.ch<\/href>\r\npsc Peter Schuetz Informatik-Dienstleistungen, CH Bern<\/description>\r\n<\/copyright>\r\n\r\nactive<\/description>\r\n<\/apiStatus>\r\nData\/CH\/BFS<\/apiName>\r\n2025-02-27<\/date>\r\n\r\n261<\/bfs>\r\n2022<\/year>\r\n4<\/class>\r\nutf-8<\/charset>\r\nxml<\/format>\r\nY-m-d<\/date_format>\r\nde<\/hl>\r\n<\/request>\r\n\r\n\r\nok<\/description>\r\n<\/status>\r\n\r\nZürich<\/description>\r\nStadt<\/type>\r\n3055<\/geoId>\r\nCH<\/iso>\r\nCH-ZH<\/iso-3166-2>\r\n<\/note>\r\n\r\n\r\nNeujahr<\/description>\r\n1<\/id>\r\n2022-01-01<\/dateStart>\r\n2022-01-01<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nBerchtoldstag<\/description>\r\n3<\/id>\r\n2022-01-02<\/dateStart>\r\n2022-01-02<\/dateEnd>\r\n4<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nKarfreitag<\/description>\r\n17<\/id>\r\n2022-04-15<\/dateStart>\r\n2022-04-15<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nOstern<\/description>\r\n18<\/id>\r\n2022-04-17<\/dateStart>\r\n2022-04-17<\/dateEnd>\r\n4<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nOstermontag<\/description>\r\n19<\/id>\r\n2022-04-18<\/dateStart>\r\n2022-04-18<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nSechseläuten<\/description>\r\n20<\/id>\r\n2022-04-25<\/dateStart>\r\n2022-04-25<\/dateEnd>\r\n4<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nTag der Arbeit<\/description>\r\n22<\/id>\r\n2022-05-01<\/dateStart>\r\n2022-05-01<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nAuffahrt<\/description>\r\n31<\/id>\r\n2022-05-26<\/dateStart>\r\n2022-05-26<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nPfingsten<\/description>\r\n30<\/id>\r\n2022-06-05<\/dateStart>\r\n2022-06-05<\/dateEnd>\r\n4<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nPfingstmontag<\/description>\r\n35<\/id>\r\n2022-06-06<\/dateStart>\r\n2022-06-06<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nNationalfeiertag Schweiz<\/description>\r\n12<\/id>\r\n2022-08-01<\/dateStart>\r\n2022-08-01<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nKnabenschiessen<\/description>\r\n60<\/id>\r\n2022-09-12<\/dateStart>\r\n2022-09-12<\/dateEnd>\r\n4<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nWeihnachten<\/description>\r\n23<\/id>\r\n2022-12-25<\/dateStart>\r\n2022-12-25<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nStephanstag<\/description>\r\n37<\/id>\r\n2022-12-26<\/dateStart>\r\n2022-12-26<\/dateEnd>\r\n2<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nWeihnachtsferien<\/description>\r\n629306<\/id>\r\n2021-12-20<\/dateStart>\r\n2022-01-01<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nSportferien<\/description>\r\n629307<\/id>\r\n2022-02-14<\/dateStart>\r\n2022-02-25<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nOsterferien<\/description>\r\n629308<\/id>\r\n2022-04-14<\/dateStart>\r\n2022-04-18<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nFrühlingsferien<\/description>\r\n629309<\/id>\r\n2022-04-18<\/dateStart>\r\n2022-04-29<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nAuffahrtsferien<\/description>\r\n629310<\/id>\r\n2022-05-26<\/dateStart>\r\n2022-05-29<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nPfingstmontag<\/description>\r\n629311<\/id>\r\n2022-06-06<\/dateStart>\r\n2022-06-06<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nSommerferien<\/description>\r\n629312<\/id>\r\n2022-07-18<\/dateStart>\r\n2022-08-19<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nKnabenschiessen<\/description>\r\n629313<\/id>\r\n2022-09-12<\/dateStart>\r\n2022-09-12<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nHerbstferien<\/description>\r\n629314<\/id>\r\n2022-10-10<\/dateStart>\r\n2022-10-21<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n\r\nWeihnachtsferien<\/description>\r\n629315<\/id>\r\n2022-12-26<\/dateStart>\r\n2023-01-06<\/dateEnd>\r\n0<\/class>\r\n100<\/percent>\r\n0<\/prov>\r\n<\/note>\r\n<\/event>\r\n<\/events>\r\n<\/location>\r\n<\/results>\r\n<\/fcal_api>" }, "application\/csv": { "example": "\"location\";\"bfs\";\"description\";\"id\";\"dateStart\";\"dateEnd\";\"class\";\"percent\";\"prov\";\"note\"\r\n\"Zürich\";\"261\";\"Neujahr\";\"1\";\"2022-01-01\";\"2022-01-01\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Berchtoldstag\";\"3\";\"2022-01-02\";\"2022-01-02\";\"4\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Karfreitag\";\"17\";\"2022-04-15\";\"2022-04-15\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Ostern\";\"18\";\"2022-04-17\";\"2022-04-17\";\"4\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Ostermontag\";\"19\";\"2022-04-18\";\"2022-04-18\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Sechseläuten\";\"20\";\"2022-04-25\";\"2022-04-25\";\"4\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Tag der Arbeit\";\"22\";\"2022-05-01\";\"2022-05-01\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Auffahrt\";\"31\";\"2022-05-26\";\"2022-05-26\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Pfingsten\";\"30\";\"2022-06-05\";\"2022-06-05\";\"4\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Pfingstmontag\";\"35\";\"2022-06-06\";\"2022-06-06\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Nationalfeiertag Schweiz\";\"12\";\"2022-08-01\";\"2022-08-01\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Knabenschiessen\";\"60\";\"2022-09-12\";\"2022-09-12\";\"4\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Weihnachten\";\"23\";\"2022-12-25\";\"2022-12-25\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Stephanstag\";\"37\";\"2022-12-26\";\"2022-12-26\";\"2\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Weihnachtsferien\";\"629306\";\"2021-12-20\";\"2022-01-01\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Sportferien\";\"629307\";\"2022-02-14\";\"2022-02-25\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Osterferien\";\"629308\";\"2022-04-14\";\"2022-04-18\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Frühlingsferien\";\"629309\";\"2022-04-18\";\"2022-04-29\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Auffahrtsferien\";\"629310\";\"2022-05-26\";\"2022-05-29\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Pfingstmontag\";\"629311\";\"2022-06-06\";\"2022-06-06\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Sommerferien\";\"629312\";\"2022-07-18\";\"2022-08-19\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Knabenschiessen\";\"629313\";\"2022-09-12\";\"2022-09-12\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Herbstferien\";\"629314\";\"2022-10-10\";\"2022-10-21\";\"0\";\"100\";\"0\";\"\"\r\n\"Zürich\";\"261\";\"Weihnachtsferien\";\"629315\";\"2022-12-26\";\"2023-01-06\";\"0\";\"100\";\"0\";\"\"" } } }, "400": { "description": "Incorrect request - missing or invalid parameters.", "content": { "application\/json": { "examples": { "not subscribed": { "summary": "You have not subscribed to the desired data.", "value": { "results": { "status": { "description": "not subscribed" } } } }, "unknown_location": { "summary": "The requested municipality number is not known.", "value": { "results": { "status": { "description": "unknown location" } } } } } } } }, "403": { "description": "Access denied - Invalid API key.", "content": { "application\/json": { "examples": { "invalid_key": { "summary": "Invalid API key.", "value": { "apiStatus": { "description": "invalid key" } } }, "invalid_usage": { "summary": "The use of this API is not enabled for this user.", "value": { "apiStatus": { "description": "invalid usage" } } }, "invalid_referer": { "summary": "Invalid access. Links from web pages (front-ends) are not allowed.", "value": { "apiStatus": { "description": "invalid referer" } } }, "inactive": { "summary": "The API has not yet been activated for use.", "value": { "apiStatus": { "description": "inactive" } } }, "expired": { "summary": "The period of use according to the contract has expired.", "value": { "apiStatus": { "description": "expired" } } } } } } }, "500": { "description": "Interner Serverfehler – ein unerwarteter Fehler ist aufgetreten.", "content": { "application\/json": { "example": { "error": { "code": 500, "message": "Interner Serverfehler. Bitte versuchen Sie es später erneut." } } } } } } } } } }