# Baugesuche Schweiz

> Free, self-service aggregator of official Swiss building-permit publications
> (Baugesuche) from 14 cantonal Amtsblatt sources (via the public
> amtsblattportal.ch API), harmonized into one model (bgch.v1), updated daily.
> Never pruned — infinite history. Legally binding is ONLY the signed official
> PDF linked on every record.

For AI agents and developers there is a full JSON/XML API, an MCP server, and an
agent-optimized reference. Start with one of these:

- Full agent reference (endpoints, fields, taxonomy, examples): https://baugesuche.switchli.ch/llms-full.txt
- Human + agent quickstart (curl/Python/JS, key form): https://baugesuche.switchli.ch/api
- OpenAPI schema: https://baugesuche.switchli.ch/api/v1/openapi.json — Swagger: https://baugesuche.switchli.ch/api/docs
- Live coverage & taxonomy (start here for a machine): https://baugesuche.switchli.ch/api/v1/meta
- MCP server (Model Context Protocol, streamable HTTP): https://baugesuche.switchli.ch/mcp
- Incremental sync for mirrors: https://baugesuche.switchli.ch/api/v1/changes?since=<ISO8601>
- RSS (same filter params): https://baugesuche.switchli.ch/feed.xml

## Quick examples
- List/filter: https://baugesuche.switchli.ch/api/v1/publications?canton=ZH&category=energie_heizung&q=W%C3%A4rmepumpe&limit=5
- Human search UI: https://baugesuche.switchli.ch/?kanton=ZH&kategorie=energie_heizung&q=W%C3%A4rmepumpe
- Per-municipality page: https://baugesuche.switchli.ch/gemeinde/winterthur

Categories (static, multi-label): energie_heizung, solar_pv, neubau_wohnen,
umbau_sanierung, abbruch, kleinbauten, gewerbe_industrie, landwirtschaft,
aussenanlagen_infrastruktur, sonstiges.
Cantons covered: ZH BE SZ OW NW ZG SO BS BL SH AR TI VS (+ CH for cross-cantonal
municipal tenants). ZH is complete by law; AG is intentionally absent (not
published via amtsblattportal.ch).

Auth: anonymous 120 req/h/IP; a free key (POST /api/v1/keys) raises it to 5000
req/h via `Authorization: Bearer bg_<key>`. Dates are ISO 8601 in the API.
Disclaimer: only the signed official PDF (links.pdf) is legally binding.