get_local_holidays
Retrieve public holidays for a Swiss municipality, including local holidays unique to that town (e.g., Zurich's Sechseläuten). Accepts municipality name or subdivision code.
Instructions
Public holidays for a single municipality or district, incl. local specifics.
Answer the locality question the canton-level tools flatten away: which holidays are observed only in this town (e.g. Zurich's Sechselaeuten)? scope is 'local' (specific here), 'regional' (canton/district) or 'national' (inherited). Accepts a name or a full subdivision code.
Answers the local question the canton-level tools flatten away: which holidays are observed only here? The city of Zurich, for example, keeps Sechseläuten and Knabenschiessen (both half-day), which the rest of the canton does not.
municipality accepts a name (e.g. "Zürich", "Morschach") or a full
subdivision code (e.g. "CH-ZH-ZH-ZH"). The result lists every holiday that
applies in that locality; each carries a scope of local (specific to this
place), regional (inherited from the canton/district) or national.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | ||
| canton | Yes | ISO code, e.g. CH-ZH | |
| language | No | DE | |
| municipality | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Human-readable caveat, set when provenance is 'degraded'. | |
| count | Yes | ||
| source | Yes | Attribution string of the upstream source. | |
| holidays | Yes | ||
| match_type | No | How the lookup key resolved (audit ARCH-003): 'exact' (code or full name / validated canton), 'fuzzy' (a single prefix match was assumed) or 'none' (nothing matched — see `note` for suggestions). | exact |
| provenance | Yes | live_api = freshly fetched, cached = in-memory cache, degraded = upstream unreachable, stale or empty payload. | |
| retrieved_at | Yes | ISO-8601 UTC timestamp of the underlying fetch. |