Die Kurtaxe als offene Schnittstelle.
Jeder Ort als JSON, mit dem Wortlaut der Satzung zu jeder Zahl und der Prüfsumme des Dokuments. Frei unter CC BY 4.0, ohne Schlüssel und ohne Anmeldung.
Stand: 18. Oktober 2026
| Adresse | Inhalt |
|---|---|
| /kurtaxe/v1/orte.json | alle Orte mit allen Feldern |
| /kurtaxe/v1/binz.json | ein Ort, hier Binz; jeder Ort unter seinem Kurznamen |
| /kurtaxe/v1/orte.csv | alle Sätze als Tabelle, eine Zeile je Ort und Saison |
| /kurtaxe/v1/aenderungen.json | beschlossene neue Sätze mit Datum, Wortlaut und Quelle |
| /kurtaxe/v1/kurtaxe.js | der Rechner dieser Seiten als JavaScript-Modul |
Was ein Ort enthält
| Feld | Bedeutung |
|---|---|
slug |
der Kurzname in der Adresse |
name |
der amtliche Name der Gemeinde |
ags |
der Amtliche Gemeindeschlüssel |
state |
das Bundesland |
district |
der Kreis |
levy.name |
die Abgabe, wie die Satzung sie nennt: Kurabgabe, Kurbeitrag, Gästebeitrag |
levy.periods |
je Saison die Zeiträume (MM-DD), der Satz für Erwachsene und je Kinderstufe, in Cent, jeweils mit Zitat |
levy.zones |
nur wo die Sätze nach Kurbezirk verschieden sind, statt levy.periods: je Bezirk label, area (das Gebiet in Worten, mit Zitat) und periods |
levy.counting |
ob An- und Abreisetag beide zählen, mit Zitat |
levy.maxNights |
höchstens so viele Nächte oder Tage, je Aufenthalt oder je Jahr, mit Zitat |
levy.exemptions |
Befreiungen in Worten, jeweils mit Zitat |
levy.remarks |
Besonderheiten in Worten, jeweils mit Zitat |
levy.hostDuty |
was der Gastgeber tut, mit Zitat |
levy.deadline |
bis wann er abführt oder meldet, mit Zitat |
levy.reporting |
wie er meldet, mit Zitat |
noLevy |
nur an Orten ohne Kurtaxe: der Beleg, dass Gäste nichts zahlen, mit Zitat; levy ist dann null |
businessLevy |
die Tourismusabgabe oder der Fremdenverkehrsbeitrag, den Vermieter selbst zahlen (an Orten ohne Kurtaxe und neben ihr), je Art der Vermietung als Betrag im Jahr je Bett, Zimmer oder Wohnung oder als Anteil am Jahresumsatz, mit Zitaten |
calculation |
dieselben Regeln in der Form, die kurtaxe.js rechnet |
registration |
ob der Ort in der Liste der Bundesnetzagentur für Registrierungsverfahren steht, mit deren Stand |
sources |
jedes Dokument mit Titel, Adresse, Gültigkeit, SHA-256-Prüfsumme und Tag der Prüfung; eine schriftliche Auskunft der Gemeinde mit ihrem Wortlaut und Eingangstag statt Adresse |
checked |
der Tag, an dem wir den Ort zuletzt geprüft haben |
Selbst rechnen
Das Modul /kurtaxe/v1/kurtaxe.js exportiert kurtaxe(calculation, stay). stay ist ein
Aufenthalt mit Anreise, Nächten, Erwachsenen, der Zahl der Kinder je Stufe und, wo es Kurbezirke gibt, dem Index des
Bezirks (zone); zurück kommt der Betrag in Cent, aufgeteilt nach Saison. Es ist derselbe Code, der auf
jeder Ortsseite rechnet.
Auf GitHub
Alle Dateien liegen auch im Repository keysethq/kurtaxe-daten, jeden Morgen von hier gespiegelt. Seine Historie ist ein Änderungsprotokoll: Jede neue Satzung, jeder neue Satz und jeder neue Ort steht als eigener Commit darin.
Lizenz
Die Daten stehen unter CC BY 4.0. Nenne „Keyset, keyset.cloud/kurtaxe“. Die Satzungen selbst sind amtliche Werke der Gemeinden. Fehler gefunden? Schreib an info@verge-one.com.
Für deine eigenen Gäste: Keyset.
Eine Buchungsseite, auf der Gäste direkt bei dir buchen und mit Karte zahlen, ohne Provision.
Fragen zur Schnittstelle
Kostet die Schnittstelle etwas?
Nein. Kein Schlüssel, keine Anmeldung, kein Limit außer dem, was ein Webserver verträgt.
Wie stabil ist sie?
Unter /kurtaxe/v1/ kommen nur Felder hinzu, keines fällt weg oder ändert seine Bedeutung. Was das bräche, erscheint unter /kurtaxe/v2/, und v1 bleibt mindestens zwölf Monate daneben bestehen. Die früheren Adressen unter /orte/v1/ leiten dauerhaft hierher weiter.
Wie prüfe ich eine Zahl selbst?
Jede Quelle hat ihre Adresse und die SHA-256-Prüfsumme des Dokuments, das wir gelesen haben. Lade es, vergleiche die Prüfsumme und such das Zitat: Es steht wörtlich darin.
Darf ich die Daten in meiner App nutzen?
Ja, auch kommerziell, unter CC BY 4.0 mit der Nennung „Keyset, keyset.cloud/kurtaxe“.