Relais-API

Version 1 · Datenstand 31.10.2026 · Ohne API-Key

Suche nach Relais in Deutschland und rufe Frequenzen, Betriebsarten und dokumentierte technische Angaben als JSON ab.

Relais

635

Kanäle

847

Erste Abfrage

GET /api/v1/relaisverzeichnis?band=70cm&betriebsart=FM

OpenAPI-Spezifikation Alle Endpunkte Nutzungsbedingungen

Endpunkte

/api/v1/relaisverzeichnis Suche und Filter

Seitenweise, 25 Relais je Seite, höchstens 50.

GET /api/v1/relaisverzeichnis?q=kassel&band=2m

/api/v1/relaisverzeichnis/{id} Ein Relais

Ein Relais mit allen Kanälen und Quellen. Die Nummer steht in jedem Treffer als id, ein unbekanntes Relais ist 404.

/api/v1/relaisverzeichnis/nearby Umkreis

Um lat und lon oder einen Locator ab vier Stellen, Vorgabe 50 km, höchstens 200 km, nächste zuerst, seitenweise. Relais ohne Standort zählt ohne_standort.

GET /api/v1/relaisverzeichnis/nearby?locator=JO41&radius_km=50

/api/v1/relaisverzeichnis/karte Kartenausschnitt

ausschnitt ist Pflicht. Bis 100 Treffer kommen Einzelpunkte, darüber Sammelpunkte mit Anzahl.

GET /api/v1/relaisverzeichnis/karte?ausschnitt=50,8,52,11

/api/v1/relaisverzeichnis/ort Mittelpunkt zu einem Ort

Liefert zu name den Mittelpunkt für den Umkreis oder einen hinweis, wenn der Name nicht eindeutig ist.

GET /api/v1/relaisverzeichnis/ort?name=Kassel

/api/v1/relaisverzeichnis/auswahl.csv CSV einzelner Relais

CSV zu ruf, kommagetrennt, höchstens 25 Rufzeichen, 30 Abrufe je Stunde.

Filter

Filter lassen sich kombinieren. Band, Betriebsart und Frequenz gelten zusammen für denselben Kanal. Mehrere Werte eines Feldes stehen kommagetrennt.

Alle Filter

Parameter	Bedeutung
`q`	Freie Suche in Rufzeichen, Ort, Betreiber, Locator-Anfang und Frequenz-Anfang
`rufzeichen`	Rufzeichen oder ein Teil davon, Ø gilt als 0
`ort`	Teil der Ortsangabe
`locator`	Anfang des Locators
`frequenz`, `toleranz_khz`	Frequenz in MHz auf Ein- oder Ausgabe, Vorgabe für die Toleranz 5 kHz
`band`	10m, 2m, 70cm, 23cm, 13cm. Andere Amateurfunkbänder wie `6m` oder `9cm` sind gültig, im Bestand aber derzeit nicht vertreten
`betriebsart`	FM, DMR, D-Star, C4FM, NXDN, P25, TETRA, M17, ATV, Transponder
`status`	`aktuell_dokumentiert` (zuletzt dokumentierter Betrieb), `frequenz_dokumentiert` (Frequenz dokumentiert, Betrieb nicht dokumentiert), `aeltere_dokumentation` (ältere Dokumentation), `ausser_betrieb` (außer Betrieb gemeldet)
`sicherheit`	hoch, mittel, gering
`mit_standort`	`1` zeigt nur Relais mit Kartenpunkt
`ruf`	Liste von Rufzeichen, kommagetrennt, höchstens 25
`lat`, `lon`, `radius_km`	Umkreis, höchstens 200 km
`ausschnitt`	Kartenausschnitt als `süd,west,nord,ost`
`sortierung`	belege, rufzeichen (Vorgabe), ort, frequenz. Im Umkreis gilt die Entfernung
`seite`, `pro_seite`	Blättern, Vorgabe 25 je Seite, höchstens 50

Grenzen

Die Liste reicht bis Treffer 200, dahinter antwortet der Server mit 400. Die API ist für gezielte Abfragen gedacht: Breite Suchen lassen sich mit Band, Ort, Locator oder Umkreis eingrenzen.
120 Abfragen je Minute, 600 Abfragen je Stunde und 30 CSV-Abrufe je Stunde. Darüber antwortet der Server mit 429, der Kopf Retry-After nennt die Wartezeit in Sekunden.
Jede Antwort trägt ein ETag. Wer es mit If-None-Match zurückschickt, bekommt bei unverändertem Datenstand 304 und keinen Inhalt.
Antworten dürfen eine Stunde zwischengespeichert werden, Zugriffe von fremden Seiten sind erlaubt.

Fehler

Fehler kommen als JSON mit dem Feld fehler und bei Eingaben zusätzlich feld. Unbekannte Filterwerte sind 400, kein leeres Ergebnis.

{"fehler": "Unbekannter Wert für band: 5m", "feld": "band"}

Datenstand

Jede Antwort mit Relais nennt in meta den Datenstand, seinen Hash und die Anzahl der Relais.

Der Status beschreibt die Dokumentation, nicht den Betrieb in diesem Moment. Eine Frequenz heißt nicht, dass das Relais in Betrieb ist. lat und lon sind die Mitte des Locators, nicht der genaue Standort. Wie die Daten entstehen, steht in der Methodik.

Quellenangabe

Wenn du die 12db-Relais-API in einer öffentlich zugänglichen Anwendung nutzt, freut sich 12db über einen gut sichtbaren Hinweis:

Relaisdaten bereitgestellt von 12db.de

Die API ist kostenlos und ohne Registrierung nutzbar. Bitte beachte die Nutzungshinweise.

Nutzung

Die API dient der Suche und dem Abruf einzelner Relaisinformationen, etwa in Apps, Logprogrammen oder Skripten von Funkamateuren. Bitte verhältnismäßig abfragen und Antworten mit ETag wiederverwenden. Eine allgemeine Freigabe der vollständigen Datenbank zur Übernahme und Weiterveröffentlichung ist derzeit nicht vorgesehen. Einzelne bekannte technische Fakten wie Frequenz, Ablage oder Ton eines Relais stellt 12db nicht als eigenes Eigentum dar.

Datenbanken und Verzeichnisse wie dieses sind samt API-Ausgaben von der allgemeinen CC-BY-SA-4.0-Lizenz ausgenommen, eigene redaktionelle Texte nicht. Einzelheiten auf der Lizenzseite.