Public Holidays API Switzerland – reliable data for all municipalities

Access carefully maintained public holiday data for all Swiss municipalities – machine-readable, multilingual, and historised since 2003. Ideal for planning, analytics, and AI models.

Why use the fcal.ch Public Holidays API?

Since 2003, we have been researching and maintaining public holiday and school holiday data with a strong focus on quality, long-term consistency, and transparency. Public PDF and iCal files serve as quality assurance, while your systems receive structured data via the API.

Long-term solution: our Public Holidays API is designed as a reliable foundation for business logic, planning, and reporting – not as a short-lived project.

Municipality-level detail: holidays are available for all Swiss municipalities, with mapping via postal code, BFS municipality ID, or GEO ID.


What does the Switzerland Public Holidays API provide?

All relevant public holidays – including cantonal and local holidays where applicable

Municipality resolution – via ZIP code, BFS ID, or GEO ID

Annual requests – one calendar year per API call

Languages German, French, Italian, and English

Combinable with school holidays – identical parameter structure, same API architecture

Historical data since 2003 – ideal for statistics, time series, and AI models

Formats – JSON, XML, or CSV for system integration


Typical use cases

Energy & grids – analyse load profiles and demand changes on public holidays

Transport & logistics – schedules, capacity, and incident management with holiday awareness

Retail & e-commerce – effects on orders, delivery times, and opening hours

HR & planning – absences, shift planning, international coordination

AI models & forecasting – holidays as features in time-series and forecasting models


Technical details

REST API – simple HTTP-based interface
Formats – JSON, XML, CSV (ideal for back-ends, BI tools, and imports)
Multilingual – documentation in German, French, Italian, and English
Secure access – SSL/TLS encrypted, API-key authentication

All interfaces are defined according to OpenAPI 3.0 and integrate seamlessly with Swagger, Postman, and OpenAPI Generator.

Note:
API requests must be made from the back-end only. Direct browser-based usage is not permitted for licensing and security reasons.

Licensing & usage

The conditions depend on:

Data scope – individual cantons or all of Switzerland

Time range – current years, planning horizons, historical periods

Usage typeinternal use or integration into your own apps / APIs (no public holidays API and no redistribution of raw data)

As a small independent provider, we ensure our data is not used to create competing services. Applications where public holiday data is the core of the product (holiday portals or public holidays APIs) are therefore not permitted.


Next steps

Simply tell us which cantons / years and which type of usage you require (internal or integration) – we will gladly prepare a tailored offer.

Request an offer


Technical details & interface list

The full interface list (holidays, school holidays, and more) is available here:

All interfaces


© 2003 - 2025 psc Peter Schütz Informatik Dienstleistungen, CH-Arch