API
Alle Daten dieser Seite gibt es auch maschinenlesbar: PLZ-Lookup, Analysewerte mit vollständiger Provenienz und versionierte TrinkwV-Grenzwerte — als JSON, read-only. Die API dient primär unseren eigenen Systemen; externe Nutzung ist auf Antrag möglich (Free Tier, 1.000 Requests/Tag).
Zugang beantragen
Kurz beschreiben, wofür du die Daten nutzen möchtest — wir prüfen den Antrag und schicken den Key per E-Mail, in der Regel innerhalb weniger Werktage.
Quickstart
curl "https://beta.maunawai.info/v1/lookup?plz=50823" \
-H "X-Api-Key: mwi_..."
Antwort: Versorgungszonen der PLZ mit Versorger, Flächenanteil und Konfidenz.
Werte je Zone: GET /v1/zones/{id}.
Endpoints
| GET /v1/lookup?plz= | PLZ → Zonen, Versorger, Ambiguität | Key |
| GET /v1/zones/{id} | Zone: aktuelle Werte + Grenzwert-Einordnung + Quellen | Key |
| GET /v1/zones/{id}/measurements | Alle Datenpunkte einer Zone (Zeitreihe, verbatim) | Key |
| GET /v1/suppliers/{id} | Versorger + seine Zonen | Key |
| GET /v1/parameters | Parameter-Register (282 Parameter) | offen |
| GET /v1/parameters/{code}/limits | Versionierte Grenzwerte (z. B. PFAS-20 ab 12.01.2026) | Key |
| GET /v1/export/plz-zonen | Komplettes PLZ↔Zonen-Mapping, JSON/CSV — ODbL | offen |
| POST /v1/keys/antrag | Zugang beantragen (Prüfung, Key per E-Mail) | offen |
Vollständige Referenz mit Schemas: interaktive Docs (OpenAPI) · openapi.json
Lizenz
Offen (ODbL): das PLZ↔Zonen-Mapping
(/v1/export/plz-zonen) basiert auf
OpenStreetMap-Daten und steht unter der
Open Database License v1.0
— Attribution: „© maunawai.info / © OpenStreetMap contributors".
Proprietär: die Messwerte-Datenbank (Analysewerte, Historie, Provenienz). Nutzung im Rahmen des Free Tiers; formale API-Terms folgen. Alle Werte stammen aus den verlinkten Pflichtveröffentlichungen der Versorger (§ 46 TrinkwV) und sind nicht amtlich.
Beta: Endpoints können sich bis zum Launch noch ändern. Feedback willkommen.