{
"openapi": "3.0.0",
"info": {
"title": "Feiertagskalender API",
"description": "This API checks the status of your API key. The required parameter is `api_key`. In addition, the output can be configured using further parameters. The parameters are passed as query parameters in the URL. Alternatively, authorisation can also take place in the header.
**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": {
"\/api_key\/index.php": {
"get": {
"tags": [
"API function control"
],
"summary": "This API checks the status of your API key. ",
"description": "**api_key** This API checks the status of your API key. The required parameter is `api_key`. In addition, the output can be configured using further parameters. The parameters are passed as query parameters in the URL. Alternatively, authorisation can also take place in the header.",
"parameters": [
{
"name": "api_key",
"in": "query",
"required": true,
"description": "Your API Key",
"schema": {
"type": "string"
}
},
{
"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"
}
}
],
"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\/api_key\/index.php?api_key=YOUR_API_KEY`\n\n**XML-Request:**\n`https:\/\/feiertagskalender.ch\/api\/api_key\/index.php?api_key=YOUR_API_KEY&format=XML`\n\n**CSV-Request:**\n`https:\/\/feiertagskalender.ch\/api\/api_key\/index.php?api_key=YOUR_API_KEY&format=CSV`\n\n",
"content": {
"application\/json": {
"example": {
"interface": "fcal API 2.0",
"source": {
"href": "https:\/\/feiertagskalender.ch",
"description": "Feiertagskalender.ch"
},
"copyright": {
"href": "https:\/\/psc.ch",
"description": "psc Peter Schuetz Informatik-Dienstleistungen, CH Arch"
},
"apiName": "api_key",
"date": "2025-02-26",
"apiKeyStatus": "active",
"apiDateStart": "2021-03-31",
"apiDateEnd": "2026-03-31",
"apiData": {
"dataPublicHolidays": "AT,CH,DE,LI",
"yearsPublicHolidays": "2020,2021,2022,2023,2024,2025,2026",
"dataSchoolHolidays": "AT,CH,DE,LI",
"yearsSchoolHolidays": "2020,2021,2022,2023,2024,2025,2026"
},
"apiList": [
{
"api": "api_key"
},
{
"api": "CheckDate\/CH\/BFS"
},
{
"api": "CheckDate\/CH\/PLZ"
},
{
"api": "CheckDate\/GeoId"
},
{
"api": "Data\/Aggreg"
},
{
"api": "Data\/CH\/BFS"
},
{
"api": "Data\/CH\/Kanton"
},
{
"api": "Data\/CH\/PLZ"
},
{
"api": "Data\/Country"
},
{
"api": "Data\/Country\/CH"
},
{
"api": "Data\/Country\/CH\/PLZ"
},
{
"api": "Data\/Country\/LI"
},
{
"api": "Data\/Country\/LI\/PLZ"
},
{
"api": "Data\/GeoId"
},
{
"api": "GeoTree\/CH"
},
{
"api": "GeoTree\/ISO"
}
]
}
},
"application\/xml": {
"schema": {
"type": "object",
"xml": {
"name": "fcal_api"
}
},
"example": "\r\nfcal API 2.0<\/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\n2025-02-26<\/date>\r\napi_key<\/apiName>\r\nactive<\/apiKeyStatus>\r\n2021-03-31<\/apiDateStart>\r\n2026-03-31<\/apiDateEnd>\r\n\r\nAT,CH,DE,LI<\/dataPublicHolidays>\r\n2020,2021,2022,2023,2024,2025,2026<\/yearsPublicHolidays>\r\nAT,CH,DE,LI<\/dataSchoolHolidays>\r\n2020,2021,2022,2023,2024,2025,2026<\/yearsSchoolHolidays>\r\n<\/apiData>\r\n\r\napi_key<\/api>\r\nCheckDate\/CH\/BFS<\/api>\r\nCheckDate\/CH\/PLZ<\/api>\r\nCheckDate\/GeoId<\/api>\r\nData\/Aggreg<\/api>\r\nData\/CH\/BFS<\/api>\r\nData\/CH\/Kanton<\/api>\r\nData\/CH\/PLZ<\/api>\r\nData\/Country<\/api>\r\nData\/Country\/CH<\/api>\r\nData\/Country\/CH\/PLZ<\/api>\r\nData\/Country\/LI<\/api>\r\nData\/Country\/LI\/PLZ<\/api>\r\nData\/GeoId<\/api>\r\nGeoTree\/CH<\/api>\r\nGeoTree\/ISO<\/api>\r\n<\/apiList>\r\n<\/fcal_api>"
},
"application\/csv": {
"example": "\"interface\";\"apiKeyStatus\";\"apiDateStart\";\"apiDateEnd\";\"dataPublicHolidays\";\"yearsPublicHolidays\";\"dataSchoolHolidays\";\"yearsSchoolHolidays\";\"api\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"api_key\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"CheckDate\/CH\/BFS\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"CheckDate\/CH\/PLZ\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"CheckDate\/GeoId\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Aggreg\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/CH\/BFS\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/CH\/Kanton\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/CH\/PLZ\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\/CH\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\/CH\/PLZ\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\/LI\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\/LI\/PLZ\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/GeoId\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"GeoTree\/CH\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"GeoTree\/ISO\""
}
}
},
"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": [
"API function control"
],
"summary": "This API checks the status of your API key. ",
"description": "**api_key** This API checks the status of your API key. The required parameter is `api_key`. 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"
},
"charset": {
"type": "string",
"enum": [
"utf-8",
"iso-8859-1"
],
"default": "utf-8"
},
"format": {
"type": "string",
"enum": [
"json",
"xml",
"csv"
],
"default": "json"
}
},
"required": [
"api_key"
]
},
"example": {
"api_key": "YOUR_API_KEY",
"format": "JSON"
}
}
}
},
"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.0",
"source": {
"href": "https:\/\/feiertagskalender.ch",
"description": "Feiertagskalender.ch"
},
"copyright": {
"href": "https:\/\/psc.ch",
"description": "psc Peter Schuetz Informatik-Dienstleistungen, CH Arch"
},
"apiName": "api_key",
"date": "2025-02-26",
"apiKeyStatus": "active",
"apiDateStart": "2021-03-31",
"apiDateEnd": "2026-03-31",
"apiData": {
"dataPublicHolidays": "AT,CH,DE,LI",
"yearsPublicHolidays": "2020,2021,2022,2023,2024,2025,2026",
"dataSchoolHolidays": "AT,CH,DE,LI",
"yearsSchoolHolidays": "2020,2021,2022,2023,2024,2025,2026"
},
"apiList": [
{
"api": "api_key"
},
{
"api": "CheckDate\/CH\/BFS"
},
{
"api": "CheckDate\/CH\/PLZ"
},
{
"api": "CheckDate\/GeoId"
},
{
"api": "Data\/Aggreg"
},
{
"api": "Data\/CH\/BFS"
},
{
"api": "Data\/CH\/Kanton"
},
{
"api": "Data\/CH\/PLZ"
},
{
"api": "Data\/Country"
},
{
"api": "Data\/Country\/CH"
},
{
"api": "Data\/Country\/CH\/PLZ"
},
{
"api": "Data\/Country\/LI"
},
{
"api": "Data\/Country\/LI\/PLZ"
},
{
"api": "Data\/GeoId"
},
{
"api": "GeoTree\/CH"
},
{
"api": "GeoTree\/ISO"
}
]
}
},
"application\/xml": {
"schema": {
"type": "object",
"xml": {
"name": "fcal_api"
}
},
"example": "\r\nfcal API 2.0<\/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\n2025-02-26<\/date>\r\napi_key<\/apiName>\r\nactive<\/apiKeyStatus>\r\n2021-03-31<\/apiDateStart>\r\n2026-03-31<\/apiDateEnd>\r\n\r\nAT,CH,DE,LI<\/dataPublicHolidays>\r\n2020,2021,2022,2023,2024,2025,2026<\/yearsPublicHolidays>\r\nAT,CH,DE,LI<\/dataSchoolHolidays>\r\n2020,2021,2022,2023,2024,2025,2026<\/yearsSchoolHolidays>\r\n<\/apiData>\r\n\r\napi_key<\/api>\r\nCheckDate\/CH\/BFS<\/api>\r\nCheckDate\/CH\/PLZ<\/api>\r\nCheckDate\/GeoId<\/api>\r\nData\/Aggreg<\/api>\r\nData\/CH\/BFS<\/api>\r\nData\/CH\/Kanton<\/api>\r\nData\/CH\/PLZ<\/api>\r\nData\/Country<\/api>\r\nData\/Country\/CH<\/api>\r\nData\/Country\/CH\/PLZ<\/api>\r\nData\/Country\/LI<\/api>\r\nData\/Country\/LI\/PLZ<\/api>\r\nData\/GeoId<\/api>\r\nGeoTree\/CH<\/api>\r\nGeoTree\/ISO<\/api>\r\n<\/apiList>\r\n<\/fcal_api>"
},
"application\/csv": {
"example": "\"interface\";\"apiKeyStatus\";\"apiDateStart\";\"apiDateEnd\";\"dataPublicHolidays\";\"yearsPublicHolidays\";\"dataSchoolHolidays\";\"yearsSchoolHolidays\";\"api\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"api_key\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"CheckDate\/CH\/BFS\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"CheckDate\/CH\/PLZ\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"CheckDate\/GeoId\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Aggreg\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/CH\/BFS\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/CH\/Kanton\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/CH\/PLZ\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\/CH\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\/CH\/PLZ\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\/LI\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/Country\/LI\/PLZ\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"Data\/GeoId\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"GeoTree\/CH\"\r\n\"fcal API 2.0\";\"active\";\"2021-03-31\";\"2026-03-31\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"AT,CH,DE,LI\";\"2020,2021,2022,2023,2024,2025,2026\";\"GeoTree\/ISO\""
}
}
},
"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."
}
}
}
}
}
}
}
}
}
}