Tagungsdaten strukturiert abrufen.

Schnellstart

curl -X POST https://www.tagungsregister.de/v1/event-venues/search \
  -H "content-type: application/json" \
  -d '{
    "event": {
      "participants": 60,
      "seating_style": "parliament",
      "bedrooms_required": 40
    },
    "origin": {"place_id": "de-berlin-hbf"},
    "travel": {"mode": "driving", "max_minutes": 120},
    "required": [
      {"criterion": "hybrid_setup", "value": true}
    ],
    "unknown_policy": "separate"
  }'

REST v1

Neu: Agent Reviews mit moderiertem Feedback über GET / POST /v1/agent-feedback. Für Einreichungen ist ein Integrationsschlüssel erforderlich; MCP bleibt lesend.

OpenAPI 3.1 herunterladen →

Datenstand und Suchlogik

Die Suchlogik kann unabhängig von den Quelldaten aktualisiert werden. data_release identifiziert die verwendeten Daten; source_matching_version und source_schema_version bewahren deren ursprünglichen Vertrag.

Mit include_decision: true ergänzt derselbe Suchaufruf die konkrete Raumplanung:

curl -X POST https://www.tagungsregister.de/v1/event-venues/search \
  -H 'content-type: application/json' \
  -d '{"event":{"participants":60,"seating_style":"parliament"},"include_decision":true,"room_requirements":{"daylight":true},"unknown_policy":"separate"}'

Ohne include_decision und room_requirements bleibt der klassische Vertrag erhalten. Die Metadaten jeder Antwort geben den tatsächlich verwendeten Vertrag an.

Profil-JSON

curl 'https://www.tagungsregister.de/v1/event-venues/estrel-berlin?include=spaces%2Clodging%2Ctravel%2Cgaps%2Cclaims%2Csources&evidence=full'

venue.spaces enthält Raumkonfigurationen und getrennte Bestuhlungswerte, keine Aussage über unabhängige parallele Nutzung. venue.gaps ordnet offene Angaben über subjectId dem Haus oder Raum zu.

Zu einer veröffentlichten Claim-ID liefert /v1/claims/<claim_id>/evidence die freigegebenen Quellen und Fundstellen. Private Quelldateien werden nicht ausgeliefert.

Eine konkrete Zahl mit Belegen abrufen

curl 'https://www.tagungsregister.de/v1/claims/30000000-0000-4000-8000-7e30e1c205b5/evidence?release=research-2026-11-06-citation-v1'

claim enthält Wert, Einheit, Raumbezug, Beobachtung, Prüfung und Gültigkeitsgrenzen; evidence und sources lösen die Fundstellen auf. citation nennt Haus und Raum, stabile Direktlinks und bekannte Einschränkungen. Die Pfade sind relativ zu dieser Domain.

Der optionale Parameter release schützt vor einer stillen Ersetzung: Ist dieser Stand nicht mehr aktiv, antwortet der Endpunkt mit 409. Historische Releases werden hier nicht abgerufen. Ein Abrufdatum bestätigt keinen neuen Dokumentstand.

Jedes menschlich lesbare Profil besitzt eine gleichnamige JSON-Variante: /tagungshotels/berlin/<slug>.json. profile enthält die strukturierte Projektion; facts enthält ausschließlich veröffentlichte Claims, deren Evidence- und Source-IDs im selben Envelope auflösbar sind.

MCP

Der read-only JSON-RPC-Endpunkt unter /mcp stellt Werkzeuge für Suche, Profilabruf, Vergleich und Evidence bereit. Er unterstützt den aktuellen zustandslosen MCP-Stand 2026-07-28 mit server/discover sowie den verbreiteten Legacy-Handshake 2025-06-18. Schreib- oder Buchungsaktionen sind nicht Teil des Registers.

curl -X POST https://www.tagungsregister.de/mcp \
  -H "content-type: application/json" \
  -H "MCP-Protocol-Version: 2026-07-28" \
  -H "Mcp-Method: server/discover" \
  -d '{
    "jsonrpc": "2.0",
    "id": "discover-1",
    "method": "server/discover",
    "params": {"_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientCapabilities": {}
    }}
  }'

Semantik

own_lodging_required: true verlangt aktuell belegte eigene Übernachtung, unabhängig von einer bekannten Zimmerzahl. event.bedrooms_required prüft zusätzlich die Mindestanzahl eigener Zimmer. Keine dieser Angaben bestätigt ein verfügbares Kontingent zum Veranstaltungstermin.

Optional prüft room_requirements: { "daylight": true } bei der Suche Tageslicht und Kapazität gemeinsam an derselben Raumkonfiguration. include_decision: true fordert die Raumprojektion auch ohne zusätzliches Mussmerkmal an. Die Suchantwort enthält höchstens drei Optionen pro Haus, Gesamtzahlen und hasMore; der Vergleich akzeptiert dieselben Kriterien im optionalen Objekt planning und liefert höchstens fünf Optionen pro Haus.

Diese optionale Auswertung verwendet Vertrag 2.3.0 und tagungsregister-match-1.2.0. Der Entscheidungskontext nennt außerdem Bewertungszeitpunkt und nächste Gültigkeitsgrenze. Ohne Planungserweiterung bleiben bestehende Aufrufe im bisherigen Modus.

Optionen werden nach Prüfstatus, aufsteigender angefragter Kapazität und stabiler ID sortiert. Die erste Option ist keine Empfehlung als „bester Raum“. Teilräume und Kombinationen dürfen nicht als unabhängig parallel nutzbare Räume addiert werden.

In Planungsantworten kennzeichnet constraints[].scope: "venue" die hausweite Prüfung. Der dortige Kapazitätswert ist das größte aktuell belegte Fassungsvermögen über die erfassten Raumkonfigurationen. Für Aussagen über einen bestimmten Raum gelten dessen decision.options[].capacity, criteria und evidence; sie beziehen sich auf dieselbe Raum-ID.

publication.status beschreibt den Datenstand eines Profils: listed, partially_verified oder comparison_ready. publication.missing_for_comparison benennt die noch offenen Bereiche. Davon getrennt bewertet eligibility die konkrete Suchanfrage.

unknown ist ein Ergebnis, kein Fehler. Ein unbekannter Wert bedeutet nicht automatisch Nein oder ungeeignet und erfüllt keinen harten Filter. Antworten sind releasegebunden, unterstützen ETags und verwenden für Fehler application/problem+json. Es gibt keine Live-Verfügbarkeit und keinen Anspruch auf Vollständigkeit.