Entwickler*innen-Dokumentation · Stand 03.11.2026

VBB Fahrinfo-API (HAFAS ReST 2.52)

Die Fahrinfo-API liefert Soll- und Echtzeitdaten des öffentlichen Verkehrs in Berlin und Brandenburg: Haltestellensuche, Abfahrts- und Ankunftstafeln, Verbindungsauskunft, Fahrtverläufe, Fahrzeugpositionen, Störungsmeldungen und Tarifinformationen. Die Schnittstelle basiert auf der HAFAS ReST-API von HaCon und ersetzt zum 30.11.2026 den bisherigen Endpunkt fahrinfo.vbb.de/restproxy (Version 2.49).

Basis-URL Produktiv
https://vbb.hafas.cloud/api/fahrinfo/latest
Basis-URL Demo
https://vbb.demo.hafas.cloud/api/fahrinfo/latest
API-Version
dialectVersion 2.52 (Server 2.52.1)
Formate
JSON, XML (Standard)
Authentifizierung
accessId (Query-Parameter)
Fahrplanperiode
25.10.2026 – 11.12.2027
Abgedeckt
38 Unternehmen · 7 Produktklassen
Umstellung
30.11.2026
Kontakt
api@vbb.de

Schnellstart

Die meisten Anwendungen kommen mit drei Aufrufen aus: Ort finden, Abfahrten anzeigen, Verbindung suchen. Ersetzen Sie in allen Beispielen $ACCESS_ID durch Ihre persönliche Zugangskennung. Die Beispiele verwenden die Basis-URL des Produktivsystems; mit einer Kennung für das Demosystem ersetzen Sie vbb.hafas.cloud durch vbb.demo.hafas.cloud.

Haltestelle per Name suchen

Die Antwort enthält zu jeder Haltestelle die extId (z. B. 900100003 für S+U Alexanderplatz).

Anfrage
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/location.name?accessId=$ACCESS_ID&input=Alexanderplatz&type=S&maxNo=5&format=json"

Abfahrten an dieser Haltestelle abrufen

Die Abfahrtstafel enthält Soll- und Echtzeit, Linie, Richtung und Gleis bzw. Steig.

Anfrage
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/departureBoard?accessId=$ACCESS_ID&id=900100003&duration=30&format=json"

Verbindung zwischen zwei Haltestellen suchen

Hier vom Alexanderplatz zum Zoologischen Garten (900023201).

Anfrage
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/trip?accessId=$ACCESS_ID&originId=900100003&destId=900023201&format=json"

Authentifizierung und Zugang

Jede Anfrage an einen Datendienst muss die persönliche Zugangskennung im Query-Parameter accessId enthalten (max. 128 Zeichen). Bestehende Kennungen aus der Version 2.49 gelten auch für die neue Schnittstelle.

Zugang beantragen

Der Zugang erfolgt in zwei Stufen: Zum Entwickeln und Testen erhalten Sie eine Kennung für das Demosystem, für den laufenden Betrieb Ihrer Anwendung den Zugang zum Produktivsystem.

DemosystemProduktivsystem
Basis-URLhttps://vbb.demo.hafas.cloud/api/fahrinfo/latesthttps://vbb.hafas.cloud/api/fahrinfo/latest
ZweckEntwicklung, Tests, AusprobierenStabiler privater oder öffentlicher Betrieb
BeantragungFormlose E-Mail an api@vbb.deFormular auf unternehmen.vbb.de
BedingungenKeine vorherige Zustimmung nötigZustimmung zu vier Bedingungen (siehe unten)
AnfragelimitsStrenger als im ProduktivsystemIndividuell vereinbart

Demosystem

Für den Einstieg genügt eine formlose E-Mail an api@vbb.de. Sie können die Schnittstelle dann unter https://vbb.demo.hafas.cloud/api/fahrinfo/latest sofort nutzen, ohne vorher Bedingungen zu akzeptieren. Das Demosystem bietet dieselben Services wie das Produktivsystem. Die Anfragelimits sind im Demosystem etwas strenger. Für den Betrieb einer Anwendung beantragen Sie anschließend den Zugang zum Produktivsystem.

Produktivsystem

Wenn Ihre Anwendung stabil läuft und privat oder öffentlich produktiv betrieben werden soll, beantragen Sie den Zugang zum Produktivsystem über das Formular auf unternehmen.vbb.de. Geben Sie dort Name bzw. Firma und E-Mail-Adresse an sowie, falls vorhanden, Ihre aktuelle Kennung für das Demosystem. Die Zugangsinformationen erhalten Sie per E-Mail.

Mit dem Antrag stimmen Sie vier Bedingungen zu:

BedingungInhalt
DatenstandDer VBB erstellt die Daten sorgfältig, übernimmt aber keine Gewähr für Richtigkeit, Vollständigkeit und Aktualität.
AusfallzeitenEs besteht kein Anspruch auf Nutzung. Der VBB bemüht sich um einen unterbrechungsfreien Betrieb, kann Ausfälle aber nicht ausschließen.
AnfragevolumenAnfragen sind effizient zu stellen. Bei übermäßiger Belastung kann der Zugang vorübergehend deaktiviert werden.
DatenquelleDer VBB wird als Quelle der Fahrplandaten genannt, zum Beispiel in den AGB oder im Impressum Ihrer Anwendung.

Maßgeblich ist der Wortlaut im Formular. Fragen zum Zugang richten Sie an api@vbb.de.

Anfragelimits

Im Produktivsystem wird die zulässige Anzahl an Anfragen für jede Kennung individuell mit dem VBB vereinbart; im Demosystem gelten etwas strengere Limits. Teilen Sie bei der Beantragung mit, welche Services Sie nutzen wollen und mit wie vielen Anfragen pro Tag und in Spitzenzeiten Sie rechnen. Wenn sich Ihr Bedarf ändert, etwa durch einen neuen Einsatzzweck oder deutlich mehr Nutzer*innen, melden Sie sich bitte vorab unter api@vbb.de.

SituationHTTPerrorCode
accessId fehlt400API_PARAM · „Missing value for required param accessId“
accessId unbekannt oder gesperrt401API_AUTH · „access denied for … on departureBoard“
Kennung nicht für diesen Service freigeschaltet401API_AUTH

Kennung schützen. Die accessId ist an Sie gebunden. Bauen Sie sie nicht in öffentlich ausgelieferten Browser- oder App-Code ein, sondern rufen Sie die API über Ihren eigenen Server auf. Die URL einer Anfrage enthält die Kennung im Klartext; achten Sie darauf, dass sie nicht in öffentlich einsehbaren Logs landet.

Der Parameter aid (max. 64 Zeichen) überschreibt serverseitige Sicherheitseinstellungen und wird nur in Sonderkonfigurationen nach Absprache mit dem VBB benötigt.

Allgemeine Konventionen

Aufbau einer Anfrage

GEThttps://vbb.hafas.cloud/api/fahrinfo/latest/{service}?accessId=…&{parameter}

Alle Parameter werden als URL-Query übergeben und müssen URL-kodiert sein (insbesondere |, @, ×, Leerzeichen und Umlaute in IDs und Kontexten). Empfohlen ist GET; POST mit Query-Parametern wird ebenfalls angenommen.

Parameter, die jeder Service kennt

ParameterTypStandardBeschreibung
accessId Pflichtstring–Zugangskennung, max. 128 Zeichen.
formatstring–json oder xml. Ohne Angabe wird der Accept-Header ausgewertet, fehlt auch dieser, antwortet der Server mit XML.
langstringdeSprache für Texte und Hinweise, z. B. en („Handicap accessible“ statt „barrierefrei“). Haltestellen- und Richtungsnamen bleiben unverändert.
requestIdstring–Eigene Kennung zur Nachverfolgung, max. 2048 Zeichen. Wird in der Antwort als requestId zurückgegeben.
aidstring–Siehe Authentifizierung.

Datentypen und Schreibweisen

ArtFormatBeispiel
DatumYYYY-MM-DDdate=2026-11-03
Uhrzeithh:mm[:ss], 24 h, Sekunden werden ignorierttime=07:45
ZeitzoneAlle Zeiten sind lokale Zeit Europe/Berlin"time":"09:52:00"
Dauer (Antwort)ISO 8601"duration":"PT12M"
Schalter0/1 oder false/truepasslist=1
KoordinatenWGS84, Dezimalgrad mit PunktoriginCoordLat=52.521508
Listenkommagetrenntlines=U5,S3
Ausschluss! vor dem Wertcategories=!Bus
PreiseCent als Ganzzahl"price":500 = 5,00 €

Unbekannte Parameter werden ignoriert. Ein falsch geschriebener Filter (z. B. lineids am departureBoard, der dort nicht existiert) führt nicht zu einem Fehler, sondern zu einem ungefilterten Ergebnis. Prüfen Sie Parameternamen gegen die Tabellen in dieser Dokumentation oder die WADL. Ungültige Werte bekannter Parameter (z. B. duration=5000) werden dagegen mit 400 API_PARAM abgelehnt.

Antwortformat

Jede erfolgreiche JSON-Antwort enthält neben den Nutzdaten diese Metadaten:

Metadaten (Auszug)
{
  "TechnicalMessages": { "TechnicalMessage": [ { "key": "requestTime", "value": "2026-11-03 09:49:46" } ] },
  "serverVersion": "2.52.1",
  "dialectVersion": "2.52",
  "planRtTs": "2026-11-03T09:49:24.000+01:00"
}

planRtTs ist der Zeitstempel des zuletzt eingespielten Echtzeitstands. Listen erscheinen in JSON immer als Array, auch bei nur einem Element. Felder ohne Wert werden weggelassen, nicht als null geliefert; behandeln Sie daher jedes Feld als optional.

Jede Antwort trägt außerdem einen Header X-Request-ID. Geben Sie diesen Wert bei Supportanfragen an.

Transport

  • Kompression: Senden Sie Accept-Encoding: gzip. Antworten werden dann komprimiert; bei den umfangreichen JSON-Antworten spart das einen Großteil der Datenmenge.
  • CORS: Der Server beantwortet Preflight-Anfragen und erlaubt Aufrufe aus dem Browser. Beachten Sie trotzdem den Hinweis zum Schutz der Kennung.
  • Zeichensatz: UTF-8.
  • Antwortzeiten: Einfache Abfragen benötigen meist unter einer Sekunde, Verbindungsauskünfte mit Tarif und Polylinien bis zu einige Sekunden. Setzen Sie Client-Timeouts nicht unter 10 Sekunden.

Haltestellen, Haltepunkte und IDs

Die Version 2.52 bildet die Haltestellen-Hierarchie des VBB vollständig ab. Das ist die wichtigste fachliche Neuerung gegenüber 2.49.

EbeneBegriff in der APIextIdBeispiel
HaltestellemainMast, isMainMast: true900xxxxxx900100003 S+U Alexanderplatz Bhf
Haltepunkt / Steig / GleisMast, hasMainMast: true300xxxxxx300003233 S-Bahnsteig Gleis 3

In Antworten steht an Abfahrten, Ankünften, Fahrtabschnitten und Halten nun die Haltepunkt-ID (stopExtId: "300306026"). Die zugehörige Haltestelle finden Sie in mainMastExtId bzw. im eingebetteten Objekt mainMast:

Abfahrt (Auszug)
{
  "stop": "S+U Alexanderplatz Bhf/Gontardstr. (Berlin)",
  "stopExtId": "300306026",
  "hasMainMast": true,
  "mainMastExtId": "900100026",
  "altId": ["A×de:11000:900100026::1", "b×BVG_301008802"],
  "mainMastAltId": ["A×de:11000:900100026", "b×BVG_100026"],
  "track": "Pos. 15"
}

Welche ID wofür?

  • Als Eingabe (id, originId, destId, viaId …) sind 9-stellige Haltestellen-IDs (900…) weiterhin die richtige Wahl. Haltepunkt-IDs (300…) werden ebenfalls akzeptiert.
  • Zum Speichern und Abgleichen eignen sich mainMastExtId oder die bundesweite DHID (Format IFOPT) aus altId mit Präfix A×, z. B. de:11000:900100003 (Haltestelle) und de:11000:900100003:2:52 (Steig). Die DHID steht zusätzlich als Hinweis mit Schlüssel IF in den Notes.
  • Der lange HAFAS-Lid-String ("id": "A=1@O=…@L=900100003@…") kann als Eingabe verwendet werden, enthält aber Versionsanteile (@p=…) und eignet sich nicht zum dauerhaften Speichern.

Weitere Präfixe in altId: b× kennzeichnet unternehmensspezifische IDs (z. B. b×BVG_100026, b×DBS_8089001).

Linien und GlobalIds

Jedes Produkt (Product, ProductAtStop, productAtStop) enthält ab 2.52 ein Objekt LineInfo mit stabilen, systemübergreifenden Linien-IDs:

LineInfo
"LineInfo": {
  "GlobalIds": [ { "id": "de:VBB:11000000|Tram|M4:", "type": "A" } ],
  "lineId": "de:VBB:11000000|Tram|M4:"
}

Zum Filtern nach diesen IDs dient der neue Parameter globallineids. Der Wert muss den Typ als Präfix tragen, getrennt durch das Zeichen × (U+00D7, URL-kodiert %C3%97):

Nur Tram M4
…/departureBoard?accessId=$ACCESS_ID&id=900100003&format=json
   &globallineids=A%C3%97de%3AVBB%3A11000000%7CTram%7CM4%3A

Ohne Präfix keine Treffer. globallineids=de:VBB:11000000|Tram|M4: (ohne A×) liefert eine leere Tafel, keinen Fehler.

Für einfache Fälle genügt der Filter lines mit dem angezeigten Liniennamen (lines=U5).

Produktklassen

Der Parameter products ist eine Bitmaske. Addieren Sie die Werte der gewünschten Klassen: products=3 liefert S- und U-Bahn, products=127 alle Klassen. Die Farben stammen aus datainfo und können für die Darstellung verwendet werden.

BitKlassecatOut (Beispiele)Farbe
1S S-BahnS#37874A
2U U-BahnU#003399
4Tram TramTram#CC0000
8Bus Bus (inkl. Rufbus, Kleinbus)Bus#993399
16F FähreFähre#0089C8
32FV Bahn-FernverkehrICE, IC, EC, RJ, NJ, EN, TLK, RJX, DRF#7D8185
64RE Bahn-RegionalverkehrRE, RB, R, BKB#E20019

Der Filter categories arbeitet mit den Kategorie-Codes (catOut), z. B. categories=!Bus für alles außer Bus. Linienfarben einzelner Linien (z. B. S3 #0066AD) stehen pro Produkt in icon.backgroundColor.

Verkehrsunternehmen

Der Filter operators akzeptiert das Kürzel (nameS) oder den vollen Namen. Die numerische id wird nicht als Filterwert erkannt. Die aktuelle Liste liefert datainfo; Stand 03.11.2026:

KürzelNameKürzelName
BVGBerliner VerkehrsbetriebeDBSS-Bahn Berlin GmbH
DBDB Regio AGODEODEG Ostdeutsche Eisenbahn GmbH
NEBNEB Betriebsgesellschaft mbHHANHanseatische Eisenbahn
MRBMitteldeutsche RegiobahnFLXFlixTrain GmbH
googo.on Gesellschaft für Bus- und Schienenverkehr mbHSTEStrausberger Eisenbahn GmbH
BUKBuckower KleinbahnSRSSchöneicher Rüdersdorfer Straßenbahn GmbH
ViPVerkehrsbetrieb Potsdam GmbHCVCottbusverkehr GmbH
SVFStadtverkehrsgesellschaft mbH Frankfurt (Oder)VBBVerkehrsbetriebe Brandenburg an der Havel GmbH
HAVHavelbus Verkehrsgesellschaft mbHregregiobus Potsdam Mittelmark GmbH
OVGOberhavel Verkehrsgesellschaft mbHBBGBarnimer Busgesellschaft mbH
VTFVerkehrsgesellschaft Teltow-Fläming mbHRVSRegionale Verkehrsgesellschaft Dahme-Spreewald mbH
VMEVerkehrsmanagement Elbe-Elster GmbHVGOVerkehrsgesellschaft Oberspreewald-Lausitz mbH
mobmobus Märkisch-Oderland Bus GmbHBOSBusverkehr Oder-Spree GmbH
UVGUckermärkische Verkehrsgesellschaft mbHORPORP Ostprignitz-Ruppiner Personennahverkehrsgesellschaft mbH
VGPVG Prignitz mbHSPNSpree-Neiße-Cottbusverkehr
DRODB Regio Bus Ost GmbHPVGPersonenverkehrsgesellschaft Altmarkkreis Salzwedel mbH
SDLstendalbusNJLNahverkehrsgesellschaft Jerichower Land mbH
MWMMWM-Solutions GmbHAngGünter Anger Güterverkehrs GmbH & Co. Omnibusvermietung KG
SCHBusverkehr Gerd SchmidtVETVetter GmbH

Echtzeit

Wo Echtzeitdaten vorliegen, stehen sie neben den Solldaten in Feldern mit Präfix rt:

SollEchtzeitBedeutung
time, datertTime, rtDateAbfahrts- bzw. Ankunftszeit
track, platformrtTrack, rtPlatformGleis / Steig
depTime, arrTimertDepTime, rtArrTimeZeiten an Zwischenhalten
durationrtDurationReisedauer einer Verbindung
  • cancelled: true kennzeichnet ausgefallene Fahrten, partCancelled Teilausfälle, reachable die Erreichbarkeit eines Anschlusses.
  • prognosisType gibt die Quelle an, z. B. PROGNOSED.
  • JourneyStatus: P = planmäßige Fahrt. Weitere Werte kennzeichnen Ersatz-, Zusatz- und Sonderfahrten; die vollständige Liste steht im XML-Schema.
  • Mit rtMode steuern Sie die Echtzeitberücksichtigung: OFF (reiner Fahrplan), SERVER_DEFAULT, bei trip/journeyDetail zusätzlich FULL, INFOS, REALTIME.

Tafeln berücksichtigen verspätete Fahrten: Eine um 09:46 geplante, auf 09:52 verspätete Abfahrt erscheint auch bei einer Anfrage um 09:50.

Alternative: GTFS-Realtime-Feed. Wenn Sie Echtzeitdaten für das gesamte Netz brauchen, statt einzelne Tafeln, Verbindungen oder Fahrten abzufragen, nutzen Sie den GTFS-RT-Feed des VBB unter https://production.gtfsrt.vbb.de/data. Er ergänzt den GTFS-Fahrplandatensatz des VBB um Echtzeitdaten. Den Fahrplandatensatz mit den reinen Solldaten laden Sie immer aktuell über vbb.de/gtfs.

  • Der Feed braucht keine Zugangskennung und steht unter der Lizenz CC-BY 4.0.
  • CORS ist aktiviert. Der Feed wird mit ETag und auf Anfrage gzip- oder zstd-komprimiert ausgeliefert.
  • Die Zahl der Abrufe ist begrenzt. Das aktuelle Limit, Statusmeldungen (Atom-Feed /news.atom.xml) und Hinweise zur Nutzung stehen auf production.gtfsrt.vbb.de.
  • Der Quellcode liegt auf GitHub unter OpenDataVBB.

Für Verbindungsauskünfte, Umgebungssuche, Fußwege und Störungsmeldungen bleibt diese Schnittstelle das passende Werkzeug.

Hinweise (Notes)

Haltestellen, Halte und Fahrten tragen Hinweise als Liste von { key, type, value, txtN, priority }. type: "A" sind Attribute für die Anzeige (z. B. Ausstattung), type: "I" sind interne oder technische Informationen. Beobachtete Schlüssel:

keyTypInhaltBeispiel
IFIDHID der Haltestelle bzw. des Steigsde:11000:900100003:2:52
Nd / NeISteigbezeichnung lang, deutsch / englisch„S-Bahnsteig Gleis 3“ / „Platform track 3“
Nf / Nu / NFISteigbezeichnung kurz bzw. Varianten„Tramsteig Gontardstraße ht. Rathausstraße Pos. 15“
SPISteigposition15
LVIEbene (Stockwerk) des Steigs-3, 0, 1
BNASteigbeschreibung für die Anzeige„S-Bahnsteig Gleis 1“
RO / AUARolltreppe / Aufzug vorhanden„Rolltreppe“, „Aufzug“
bf, B=, B-ABarrierefreiheit„barrierefrei“, „nicht barrierefrei“
FBAFahrradmitnahme möglich„Fahrradmitnahme möglich“
QRIHaltestellen-QR-Code eines UnternehmensBVG;308802

Die Liste ist nicht abschließend. Zeigen Sie unbekannte Attribute (type: "A") über txtN an, statt sie zu verwerfen. Mit baim=1 liefern trip, journeyDetail, Tafeln und gisroute zusätzliche Barrierefreiheits-Informationen (BAIM).


location.name: Orte nach Namen suchen

GET/latest/location.name

Findet Haltestellen, Adressen und Points of Interest zu einer Texteingabe. Typischer Einsatz: Autovervollständigung im Suchfeld, Auflösung von Haltestellennamen in IDs.

ParameterTypStandardBeschreibung
input Pflichtstring–Suchbegriff, max. 512 Zeichen. Teileingaben wie „Alexanderpl“ werden ergänzt.
typeenumALLS Haltestellen · A Adressen · P POI · SA, SP, AP Kombinationen · ALL alles
maxNoint10Maximale Trefferzahl, 1–1000.
productsint–Nur Haltestellen mit diesen Produktklassen.
operators neustring–Nur Orte, die von diesen Unternehmen bedient werden. Negation mit !.
coordLat, coordLongdouble–Mittelpunkt, um Treffer in der Nähe zu bevorzugen oder einzuschränken.
rint1000Radius in Metern um coordLat/coordLong.
filterModeenumDIST_PERIDIST_PERI Nähe gewichtet · EXCL_PERI nur außerhalb · SLCT_PERI nur innerhalb des Radius.
withEquivalentLocationsboolfalseGleichwertige Haltestellen (gleicher Knoten) als equivalentStopLocation mitliefern.
withProductsbooltrueListe der Linien je Haltestelle (productAtStop) mitliefern. Auf 0 setzen verkleinert die Antwort deutlich.
productRepresentativesbool–Pro Kategorie nur ein repräsentatives Produkt.
locationSelectionModeenum–SLCT_N normal · SLCT_A nur für Abfahrtstafeln geeignete Orte.
restrictSelectionenumSEinschränkung erlaubter Stationen (S, D, I, V).
stationsstring–Nur IDs, die mit diesen Präfixen beginnen.
sattributesstring–Filter auf Haltestellen-Attribute, Negation mit !.
sinfotextsstring–Filter auf Infotexte, Format code|wert.
metastring–Vordefinierter Filter der Installation.
poolIdstring–Filter auf Pool-UIC-Codes.
refineIdstring–ID eines verfeinerbaren Treffers aus einer vorherigen Antwort.
Beispielanfrage
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/location.name?accessId=$ACCESS_ID&input=Zoologischer%20Garten&type=S&maxNo=3&withProducts=0&format=json"
Beispielantwort (gekürzt)
{
  "stopLocationOrCoordLocation": [
    {
      "StopLocation": {
        "id": "A=1@O=S+U Zoologischer Garten Bhf (Berlin)@X=13332711@Y=52506919@U=86@L=900023201@p=1793325983@",
        "extId": "900023201",
        "name": "S+U Zoologischer Garten Bhf (Berlin)",
        "lon": 13.332711,
        "lat": 52.506919,
        "weight": 24772,
        "products": 107,
        "isMainMast": true,
        "altId": ["A×de:11000:900023201", "b×BVG_23201", "b×DBS_23201"],
        "LocationNotes": { "LocationNote": [
          { "key": "IF", "type": "I", "value": "de:11000:900023201", "txtN": "de:11000:900023201" }
        ] }
      }
    },
    { "StopLocation": { "extId": "900023172", "name": "S+U Zoologischer Garten/Jebensstr. (Berlin)", "products": 8, "isMainMast": true } },
    { "StopLocation": { "extId": "900066102", "name": "S Botanischer Garten (Berlin)", "products": 9, "isMainMast": true } }
  ],
  "serverVersion": "2.52.1",
  "dialectVersion": "2.52"
}

Adressen und POIs erscheinen als CoordLocation mit type ADR bzw. POI, Koordinaten und Namen. Für eine Verbindungsauskunft zu einer Adresse übergeben Sie deren lat/lon als originCoordLat/originCoordLong.

Antwortgröße. Ohne withProducts=0 enthält jeder Haltestellentreffer die vollständige Linienliste und gleichwertige Haltestellen. Für „Alexanderplatz“ mit 10 Treffern sind das über 200 KB. Für Autovervollständigung reicht withProducts=0.

location.nearbystops: Orte in der Umgebung

GET/latest/location.nearbystops

Liefert Haltestellen (und optional POIs) rund um eine Koordinate, sortiert nach Entfernung (dist in Metern).

ParameterTypStandardBeschreibung
originCoordLat Pflichtdouble–Breitengrad des Mittelpunkts.
originCoordLong Pflichtdouble–Längengrad des Mittelpunkts.
rint1000Suchradius in Metern.
maxNoint10Maximale Trefferzahl, 1–1000.
typestringSS Haltestellen · P POI · SP beides.
productsint–Produkt-Bitmaske.
date, timestringjetztBezugszeitpunkt für zeitabhängige Verfügbarkeit.
duration neuint40320Zeitraum in Minuten (1–40320), für den die Verfügbarkeit eines Orts geprüft wird.
zoomint–Kartenzoomstufe 0–21; liefert die für diese Zoomstufe relevantesten Haltestellen.
poiCategoriesstring–POI-Kategorien, Negation mit !.
locationSelectionMode, meta, poolId, sattributes, sinfotextsWie bei location.name.
Beispielanfrage
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/location.nearbystops?accessId=$ACCESS_ID&originCoordLat=52.521508&originCoordLong=13.411267&r=500&maxNo=10&format=json"
Beispielantwort (gekürzt)
{
  "stopLocationOrCoordLocation": [
    {
      "StopLocation": {
        "extId": "300003233",
        "name": "S+U Alexanderplatz Bhf (Berlin)",
        "lon": 13.411223,
        "lat": 52.521517,
        "dist": 3,
        "products": 67,
        "hasMainMast": true,
        "mainMastExtId": "900100003",
        "altId": ["A×de:11000:900100003:2:52"],
        "LocationNotes": { "LocationNote": [
          { "key": "Nd", "type": "I", "value": "S-Bahnsteig Gleis 3" },
          { "key": "Ne", "type": "I", "value": "Platform track 3" }
        ] }
      }
    },
    { "StopLocation": { "extId": "300003234", "name": "S+U Alexanderplatz Bhf (Berlin)", "dist": 10, "mainMastExtId": "900100003" } }
  ]
}

Die Umgebungssuche liefert Haltepunkte (300…) mit Verweis auf ihre Haltestelle. Für eine Liste eindeutiger Haltestellen gruppieren Sie die Treffer nach mainMastExtId.

departureBoard: Abfahrtstafel

GET/latest/departureBoard

Liefert die Abfahrten an einer Haltestelle in einem Zeitfenster, mit Echtzeit, Gleis/Steig und optional dem weiteren Fahrtverlauf.

ParameterTypStandardBeschreibung
Ort und Zeit
id Pflichtstring–Haltestellen- oder Haltepunkt-ID. extId ist veraltet, funktioniert aber weiterhin.
datestringheuteStartdatum YYYY-MM-DD.
timestringjetztStartzeit hh:mm.
durationint60Länge des Zeitfensters in Minuten, 0–1439.
maxJourneysint-1Maximale Anzahl Abfahrten; -1 = alle im Zeitfenster.
typeenumDEPDEP wie konfiguriert (Haltestelle inkl. aller Steige) · DEP_MAST nur der angefragte Haltepunkt · DEP_STATION alle Masten der Haltestelle · DEP_EQUIVS zusätzlich gleichwertige Haltestellen.
Filter
productsint–Produkt-Bitmaske, z. B. 1 = nur S-Bahn.
linesstring–Liniennamen, z. B. U5,S3; !M4 schließt aus.
globallineids neustring–Globale Linien-IDs mit Typpräfix, siehe Linien.
operatorsstring–Unternehmen (Kürzel oder Name), Negation mit !.
categoriesstring–Kategorien (catOut), Negation mit !.
directionstring–Nur Fahrten, die über diese Haltestelle (ID) fahren.
platformsstring–Nur diese Gleise/Steige, kommagetrennt.
attributesstring–Fahrt-Attribute, Negation mit !.
minDurint–Mindestrestfahrzeit einer Fahrt in Minuten.
Ausgabe
passlistboolfalseFolgende Halte jeder Fahrt als Stops.Stop[] mitliefern.
passlistMaxStopsint–Anzahl der Halte in der Passliste begrenzen.
rtModeenumSERVER_DEFAULTOFF schaltet Echtzeit ab.
baimboolfalseBarrierefreiheitsinformationen (BAIM).
Beispielanfrage: nächste Abfahrten am Alexanderplatz
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/departureBoard?accessId=$ACCESS_ID&id=900100003&duration=30&maxJourneys=5&format=json"
Variante: nur S-Bahn, ohne Busse, nur U5
…/departureBoard?accessId=$ACCESS_ID&id=900100003&products=1&format=json
…/departureBoard?accessId=$ACCESS_ID&id=900100003&categories=!Bus&format=json
…/departureBoard?accessId=$ACCESS_ID&id=900100003&lines=U5&format=json
Beispielantwort (gekürzt, eine Abfahrt)
{
  "Departure": [
    {
      "name": "M4",
      "type": "ST",
      "stop": "S+U Alexanderplatz Bhf/Gontardstr. (Berlin)",
      "stopExtId": "300306026",
      "mainMastExtId": "900100026",
      "lon": 13.411339,
      "lat": 52.521032,
      "time": "09:46:00",
      "date": "2026-11-03",
      "rtTime": "09:52:00",
      "rtDate": "2026-11-03",
      "prognosisType": "PROGNOSED",
      "track": "Pos. 15",
      "platform": { "type": "PL", "text": "Pos. 15" },
      "direction": "S Hackescher Markt",
      "directionFlag": "1",
      "reachable": true,
      "entry": true,
      "JourneyStatus": "P",
      "JourneyDetailRef": { "ref": "1|76836|0|86|3112026" },
      "ProductAtStop": {
        "name": "M4",
        "displayNumber": "M4",
        "line": "M4",
        "lineId": "de:VBB:11000000|Tram|M4:",
        "LineInfo": { "GlobalIds": [ { "id": "de:VBB:11000000|Tram|M4:", "type": "A" } ] },
        "catOut": "Tram",
        "cls": "4",
        "operatorCode": "BVG",
        "operator": "Berliner Verkehrsbetriebe",
        "icon": { "backgroundColor": { "hex": "#CC0000" }, "foregroundColor": { "hex": "#FFFFFF" } }
      },
      "Notes": { "Note": [
        { "key": "FB", "type": "A", "value": "Fahrradmitnahme möglich", "priority": 350 },
        { "key": "bf", "type": "A", "value": "barrierefrei", "priority": 920 },
        { "key": "BN", "type": "A", "value": "Tramsteig Gontardstraße hinter Rathausstraße Position 15" }
      ] }
    }
  ],
  "serverVersion": "2.52.1",
  "dialectVersion": "2.52",
  "planRtTs": "2026-11-03T09:49:24.000+01:00"
}
  • Mit der ID einer Haltestelle (900100003) enthält die Tafel alle Steige des Knotens, auch Tram- und Busstationen in der Umgebung, sofern sie zur Haltestelle gehören. Für einen einzelnen Bahnsteig fragen Sie die Haltepunkt-ID mit type=DEP_MAST ab.
  • JourneyDetailRef.ref verwenden Sie für journeyDetail.
  • Sortiert wird nach Sollzeit. Wer nach tatsächlicher Abfahrt sortieren möchte, sortiert clientseitig nach rtTime (falls vorhanden, sonst time).

arrivalBoard: Ankunftstafel

GET/latest/arrivalBoard

Gegenstück zur Abfahrtstafel. Parameter und Filter sind identisch mit departureBoard, mit diesen Unterschieden:

  • type: ARR (Standard), ARR_MAST, ARR_STATION, ARR_EQUIVS.
  • Die Antwort enthält Arrival[] statt Departure[]; statt direction steht die Herkunft in origin.
  • Der Parameter direction filtert hier auf Fahrten, die von der angegebenen Haltestelle kommen.
Beispielanfrage
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/arrivalBoard?accessId=$ACCESS_ID&id=900100003&duration=30&maxJourneys=3&format=json"
Beispielantwort (gekürzt)
{
  "Arrival": [
    {
      "name": "M4",
      "stop": "S+U Alexanderplatz Bhf/Gontardstr. (Berlin)",
      "stopExtId": "300306026",
      "mainMastExtId": "900100026",
      "time": "09:46:00",
      "date": "2026-11-03",
      "rtTime": "09:52:00",
      "rtDate": "2026-11-03",
      "track": "Pos. 15",
      "origin": "Zingster Str. (Berlin)",
      "reachable": true,
      "entry": true,
      "JourneyDetailRef": { "ref": "1|76836|0|86|3112026" },
      "ProductAtStop": { "name": "M4", "catOut": "Tram", "cls": "4", "operatorCode": "BVG" }
    }
  ]
}

trip: Verbindungsauskunft

GET/latest/trip

Berechnet Verbindungen zwischen zwei Orten (Haltestelle, Adresse oder Koordinate), optional über Zwischenhalte, mit Echtzeit, Tarif, Fußwegen und Polylinien.

Start und Ziel

Pro Ende genau eine Variante angeben:

  • Haltestelle: originId / destId (z. B. 900100003)
  • Koordinate: originCoordLat + originCoordLong bzw. destCoordLat + destCoordLong, optional mit originCoordName/destCoordName als Anzeigename
ParameterTypStandardBeschreibung
Start, Ziel, Via
originId, destIdstring–Haltestellen-ID. originExtId/destExtId sind veraltet.
originCoordLat/Long, destCoordLat/Longdouble–Koordinaten (WGS84).
originCoordName, destCoordNamestring–Anzeigename, falls die Koordinate nicht aufgelöst werden kann.
originCoordType, destCoordTypeenum–A, ALL, C, P, S
viaIdstring–Haltestelle, über die gefahren werden muss.
viaWaitTimeint0Aufenthalt am Via-Halt in Minuten.
viastring–Mehrere Via-Punkte, durch ; getrennt (komplexe Struktur).
viaGisstring–Via-Orte für Individualverkehrsabschnitte.
avoidId, avoidstring–Haltestelle(n), an denen nicht umgestiegen werden soll.
Zeit und Umfang
date, timestringjetztAbfahrtszeitpunkt.
searchForArrivalboolfalse1: date/time gelten als gewünschte Ankunft.
numFint5Mindestanzahl Verbindungen nach dem Suchzeitpunkt, 1–6.
numBint0Mindestanzahl Verbindungen davor, 0–5. numF + numB ≤ 6.
contextstring–Blättern: Wert aus scrF (später) oder scrB (früher) der vorigen Antwort.
includeEarlierboolfalseOptimierung nach Reisedauer abschalten, frühere Abfahrten zulassen.
Verkehrsmittel und Linien
productsint–Produkt-Bitmaske.
lines, lineids, globallineids neustring–Linienfilter (Name / lineId / GlobalId mit Präfix), Negation mit !.
operators, categories, categoryFlagsstring–Unternehmen, Kategorien, Kategorie-Flags.
attributes, sattributes, fattributesstring–Fahrt-, Haltestellen- und Fußweg-Attribute.
mobilityProfilestring–Mobilitätsprofil für die barrierefreie Suche: limitedBarrierfree (bedingt barrierefrei) oder completeBarrierfree (voll barrierefrei).
groupFilterstring–Vordefinierte Filter der Installation.
trainFilterstring–Suche auf einen bestimmten Zug einschränken.
bikeCarriageboolfalseNur Verbindungen mit Fahrradmitnahme.
bikeCarriageTypeenum–SINGLEBIKES, SMALLGROUPS, LARGEGROUPS
sleepingCar, couchetteCoachboolfalseNur Verbindungen mit Schlaf- bzw. Liegewagen.
includeDrtbooltrueBedarfsverkehre (Rufbus, On-Demand) einbeziehen.
Umstiege
maxChangeint–Maximale Anzahl Umstiege, 0–11.
minChangeTime, maxChangeTimeint–Minimale / maximale Umstiegszeit in Minuten.
addChangeTimeint–Zusätzliche Minuten an jedem Umstieg.
changeTimePercentint100Umstiegszeiten skalieren; 200 verdoppelt sie (langsameres Gehen).
withICTAlternativesboolfalseAlternativen mit individuellen Umstiegszeiten suchen.
blockedEdges, blockingList, avoidPathsstring–Netzabschnitte oder Pfadeigenschaften ausschließen.
Fußweg, Rad, Auto (Zu- und Abgang)
originWalk, destWalk, totalWalkstring–Fußwege am Start, am Ziel bzw. für die gesamte Strecke steuern.
originBike, destBike, totalBikestring–Fahrradabschnitte.
originCar, destCar, totalCarstring–Autoabschnitte.
originTaxi, destTaxi, totalTaxistring–Taxiabschnitte.
originPark, destParkstring–Park+Ride.
originMeta, destMeta, totalMetastring–Vordefinierte Profile für Individualverkehr.
includeIv, ivOnlyboolfalseReine Individualverkehrsrouten zusätzlich bzw. ausschließlich.
gisProductsstring–Sharing-Anbieter ausschließen (!code).
allowFootpathEquivalencesbooltrueBei abgeschaltetem Fußweg gleichwertige, per Fußpfad verbundene Haltestellen erlauben.
Ausgabe
passlistboolfalseZwischenhalte je Abschnitt.
showPassingPointsboolfalseAuch Durchfahrten ohne Halt (benötigt passlist).
polyboolfalsePolylinien je Abschnitt.
polyEncenumNN unkodiert · DLT Delta · GPA Google Encoded Polyline.
tariffboolKonfig.Tarifauskunft (TariffResult).
trafficMessagesboolKonfig.Störungsmeldungen je Verbindung.
withFreqbooltrueTaktinformationen (Freq).
withJourneyBoundaryPointsboolfalseStart- und Endhalt der gesamten Fahrt je Abschnitt.
trainCompositionboolfalseZugbildung, soweit vorhanden.
baimboolfalseBarrierefreiheitsinformationen; zusammen mit mobilityProfile für die barrierefreie Suche.
rtModeenum–FULL, INFOS, OFF, REALTIME, SERVER_DEFAULT
Sonstiges
economic, unsharpboolfalseSparsamer bzw. unscharfer Suchmodus.
travellerProfileDatastring–Reisendenprofil (Struktur installationsabhängig).
eco, ecoCmp, ecoParamsfalseUmweltwerte. eco/ecoCmp sind veraltet.
Beispielanfrage: Haltestelle zu Haltestelle
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/trip?accessId=$ACCESS_ID&originId=900100003&destId=900023201&numF=2&format=json"
Beispielanfrage: Koordinate zu Koordinate mit Tarif und Polylinie
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/trip?accessId=$ACCESS_ID\
&originCoordLat=52.5163&originCoordLong=13.3777&originCoordName=Brandenburger%20Tor\
&destCoordLat=52.3906&destCoordLong=13.0645\
&numF=1&poly=1&tariff=1&format=json"
Beispielantwort (gekürzt)
{
  "Trip": [
    {
      "idx": 0,
      "tripId": "C-0",
      "duration": "PT51M",
      "Origin": { "name": "Brandenburger Tor", "type": "ADR", "time": "09:57:00", "date": "2026-11-03" },
      "Destination": { "name": "52.390600, 13.064500", "type": "ADR", "time": "10:48:00" },
      "LegList": { "Leg": [
        { "type": "WALK", "name": "Fußweg", "dist": 295, "duration": "PT4M",
          "Origin": { "name": "Brandenburger Tor", "time": "09:57:00" },
          "Destination": { "name": "S+U Brandenburger Tor (Berlin)", "extId": "300223072", "time": "10:01:00" },
          "GisRef": { "ref": "¶G|1|G@F|A=2@O=Brandenburger Tor@…" } },
        { "type": "JNY", "name": "S26", "direction": "S Blankenburg (Berlin)", "duration": "PT1M",
          "Origin":      { "name": "S+U Brandenburger Tor (Berlin)", "extId": "300223072", "time": "10:01:00", "track": "2" },
          "Destination": { "name": "S+U Friedrichstr. Bhf (Berlin)", "extId": "300005612", "time": "10:02:00" },
          "JourneyDetailRef": { "ref": "1|8579|6|86|3112026|C:B" },
          "Product": [ { "name": "S26", "catOut": "S", "cls": "1", "LineInfo": { "GlobalIds": [ "…" ] } } ],
          "minimumChangeDuration": "PT0S" },
        { "type": "WALK", "name": "Fußweg", "dist": 81, "duration": "PT2M",
          "Origin": { "name": "S+U Friedrichstr. Bhf (Berlin)", "extId": "300005612", "time": "10:02:00" },
          "Destination": { "name": "S+U Friedrichstr. Bhf (Berlin)", "extId": "300005466", "time": "10:04:00" } },
        { "type": "JNY", "name": "S7", "direction": "S Potsdam Hauptbahnhof", "duration": "PT38M",
          "Origin": { "extId": "300005466", "time": "10:04:00", "track": "6" },
          "Destination": { "name": "S Potsdam Hauptbahnhof", "extId": "300501057", "time": "10:42:00" },
          "JourneyDetailRef": { "ref": "1|4700|0|86|3112026|C:B" } },
        { "type": "WALK", "name": "Fußweg", "dist": 296, "duration": "PT6M" }
      ] },
      "TariffResult": { "fareSetItem": [
        { "name": "Berlin Tarifgebiet A-B-C: Einzelfahrausweis", "desc": "Via: Berlin ABC",
          "fareItem": [
            { "name": "Regeltarif", "price": 500, "cur": "EUR" },
            { "name": "Ermäßigungstarif", "price": 350, "cur": "EUR" },
            { "name": "Fahrrad", "price": 330, "cur": "EUR" }
          ] },
        { "name": "Berlin Tarifgebiet A-B-C: 4-Fahrten-Karte", "fareItem": [ { "name": "Regeltarif", "price": 1680, "cur": "EUR" } ] }
      ] },
      "ctxRecon": "¬¶BAIM¶t¬¶HKI¶T$A=1@O=S+U Brandenburger Tor (Berlin)@L=300223072@…",
      "checksum": "…"
    }
  ],
  "scrB": "3|OB|MTµ14µ16433µ…",
  "scrF": "3|OF|MTµ14µ16438µ…",
  "serverVersion": "2.52.1",
  "dialectVersion": "2.52"
}

Aufbau einer Verbindung

  • LegList.Leg[] enthält die Abschnitte. type: JNY Fahrt mit einem Verkehrsmittel, WALK Fußweg; bei aktiviertem Individualverkehr zusätzlich Typen wie BIKE oder TAXI. Behandeln Sie unbekannte Typen als generischen Abschnitt.
  • Umstiege innerhalb großer Bahnhöfe erscheinen als eigener WALK-Abschnitt zwischen zwei Haltepunkten (oben: 81 m in Friedrichstraße).
  • GisRef.ref eines Fußwegs liefert über gisroute die Wegbeschreibung.
  • ctxRecon beschreibt die Verbindung als Kontext. Behandeln Sie den Wert als undurchsichtig und kurzlebig.
  • scrF/scrB als context übergeben, um spätere bzw. frühere Verbindungen zu laden.

Polylinien

Mit poly=1 enthält jeder Fahrtabschnitt PolylineGroup.polylineDesc[].crd, Fußwege GisRoute.polylineGroup. crd ist eine flache Liste [lon, lat, lon, lat, …]. Mit polyEnc=GPA erhalten Sie stattdessen eine Google-Encoded-Polyline (crdEncS), was die Antwort deutlich verkleinert.

Barrierefreie Verbindungssuche

Für mobilitätseingeschränkte Reisende sucht trip Verbindungen, die nur Wege nutzen, die für das gewählte Profil geeignet sind. Übergeben Sie dazu baim=1 und ein Mobilitätsprofil in mobilityProfile. Die beiden Profile entsprechen den Auswahlmöglichkeiten der VBB-Fahrinfo:

mobilityProfileVBB-FahrinfoWirkung
limitedBarrierfreebedingt barrierefreiWege ohne feste Treppen; Rolltreppen sind erlaubt.
completeBarrierfreevoll barrierefreiWege ohne Treppen und Rolltreppen, zum Beispiel über Aufzüge.
Beispielanfrage: voll barrierefrei
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/trip?accessId=$ACCESS_ID&originId=900100003&destId=900023201\
&baim=1&mobilityProfile=completeBarrierfree&numF=3&format=json"

Die Antwort hat denselben Aufbau wie eine normale Verbindungsauskunft. Zusätzlich beschreibt die Verbindung den Weg innerhalb der Bahnhöfe: Vor und nach der Fahrt stehen eigene WALK-Abschnitte vom Zugang zum Bahnsteig, deren GisRoute.seg[] Aufzüge oder Rolltreppen benennt. Dieselbe Fahrt von Alexanderplatz zum Zoologischen Garten am Vormittag:

SucheErste VerbindungWeg zum Bahnsteig am Alexanderplatz
ohne ProfilS7, 13 Min.nicht ausgewiesen
limitedBarrierfreeFußweg 1 Min. · S9 · Fußweg 2 Min., 16 Min.„Bahnhofshalle Rolltreppe zum Bahnsteig Gleis 3+4“, „Rolltreppe aufwärts“
completeBarrierfreeFußweg 3 Min. · S3 · Fußweg 3 Min., 20 Min.„Bahnhofshalle Aufzug zum Bahnsteig Gleis 3+4“, „Aufzug aufwärts“
Beispielantwort (gekürzt, erster Abschnitt, completeBarrierfree)
{
  "type": "WALK", "name": "Fußweg", "duration": "PT3M", "dist": 89,
  "Origin":      { "name": "S+U Alexanderplatz Bhf (Berlin)", "extId": "300003304", "time": "09:01:00" },
  "Destination": { "name": "S+U Alexanderplatz Bhf (Berlin)", "extId": "300003234", "time": "09:04:00" },
  "GisRoute": { "seg": [
    { "man": "NO", "manTx": "Fußweg", "dist": 7 },
    { "man": "NO", "manTx": "Bahnhofshalle Aufzug zum Bahnsteig Gleis 3+4" },
    { "man": "NO", "manTx": "Aufzug aufwärts", "dist": 0 },
    { "man": "NO", "manTx": "Bahnsteig Gleis 3+4 Aufzug zur Bahnhofshalle" },
    { "man": "NO", "manTx": "Fußweg", "dist": 82 }
  ] }
}
  • Fahrtabschnitte tragen weiterhin den Hinweis bf („barrierefrei“) bzw. „nicht barrierefrei“, siehe Hinweise.
  • Barrierefreie Verbindungen sind oft etwas länger, weil Aufzüge oder andere Zugänge Umwege bedeuten.
  • Für langsameres Gehen lassen sich die Umstiegszeiten zusätzlich mit changeTimePercent verlängern.

Profilnamen exakt schreiben. Ein unbekannter Wert in mobilityProfile wird ohne Fehlermeldung ignoriert; die Antwort ist dann eine normale, nicht barrierefreie Verbindungssuche. Auch baim=1 allein ändert die Suche nicht. Entscheidend ist das Profil.

journeyDetail: Fahrtverlauf

GET/latest/journeyDetail

Liefert den vollständigen Laufweg einer einzelnen Fahrt (Zug, Bus, Tram) mit allen Halten, Soll- und Echtzeiten, Gleisen und Hinweisen.

ParameterTypStandardBeschreibung
id Pflichtstring–Wert aus JourneyDetailRef.ref einer Tafel, Verbindung oder Fahrzeugposition, URL-kodiert.
datestring–Betriebstag.
fromId, toIdstring–Nur den Teil zwischen diesen Haltestellen liefern.
fromIdx, toIdxint–Wie oben, über die Position im Laufweg (routeIdx).
poly, polyEncfalse, NPolylinie der Fahrt.
showPassingPointsboolfalseAuch Durchfahrten ohne Halt.
rtMode, baimWie bei trip.
Beispielanfrage
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/journeyDetail?accessId=$ACCESS_ID&id=1%7C1954%7C5%7C86%7C3112026&format=json"
Beispielantwort (gekürzt)
{
  "ref": "1|1954|5|86|3112026|C:B",
  "dayOfOperation": "2026-11-03",
  "reachable": true,
  "JourneyStatus": "P",
  "Directions": { "Direction": [ { "value": "S Spandau Bhf (Berlin)", "flag": "1", "routeIdxFrom": 0, "routeIdxTo": 29 } ] },
  "Product": [ { "name": "S3", "catOut": "S", "lineId": "de:VBB:11000000|S-Bahn|S3:S3-B", "operatorCode": "DBS" } ],
  "Stops": { "Stop": [
    { "name": "S Erkner Bhf", "extId": "300269032", "routeIdx": 0,
      "depTime": "09:14:00", "rtDepTime": "09:14:00", "depTrack": "32" },
    { "name": "S Wilhelmshagen (Berlin)", "extId": "300268001", "routeIdx": 1,
      "arrTime": "09:17:00", "depTime": "09:17:00", "arrTrack": "1",
      "Notes": { "Note": [ { "key": "BN", "type": "A", "value": "S-Bahnsteig Gleis 1" } ] } },
    "… 27 weitere Halte …",
    { "name": "S Spandau Bhf (Berlin)", "routeIdx": 29, "arrTime": "10:26:00" }
  ] },
  "ServiceDays": [ {
    "planningPeriodBegin": "2026-10-25", "planningPeriodEnd": "2027-12-11",
    "sDaysR": "nicht täglich", "sDaysI": "3. bis 25. Nov 2026 Mo - Fr",
    "sDaysB": "1CF9F3E70000…"
  } ]
}

Referenzen sind nicht dauerhaft. JourneyDetailRef.ref gilt nur für den Betriebstag und den aktuellen Datenstand und ist nicht zwischen Systemen austauschbar. Referenzen aus der alten Schnittstelle 2.49 werden mit 400 SVC_PARAM abgelehnt. Holen Sie die Referenz immer frisch aus einer aktuellen Antwort.

gisroute: Fußweg- und Individualverkehrsroute

GET/latest/gisroute

Liefert zu einem Fuß-, Rad- oder Autoabschnitt einer Verbindung die detaillierte Route mit Abbiegehinweisen, Distanzen und Polylinie.

ParameterTypStandardBeschreibung
ctx Pflichtstring–Wert aus Leg.GisRef.ref, URL-kodiert.
polyboolfalsePolylinie mitliefern.
polyEncenumNN, DLT, GPA.
baimboolfalseBarrierefreiheitsinformationen (z. B. Treppen, Aufzüge).
ecoboolfalseUmweltwerte.
Beispielanfrage
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/gisroute?accessId=$ACCESS_ID&poly=1&format=json&ctx=%C2%B6G%7C1%7CG%40F%7CA%3D2%40O%3DBrandenburger%20Tor…"
Beispielantwort (gekürzt)
{
  "Trip": [ {
    "Origin": { "name": "Brandenburger Tor", "type": "ADR", "lon": 13.3777, "lat": 52.5163, "time": "09:57:00" },
    "Destination": { "name": "S+U Brandenburger Tor (Berlin)", "extId": "300223072" },
    "LegList": { "Leg": [ {
      "type": "WALK", "dist": 295, "duration": "PT4M",
      "GisRoute": {
        "seg": [
          { "dist": 158, "man": "FR", "manTx": "Start", "ori": "E", "polyS": 0, "polyE": 11 },
          { "dist": 0, "man": "TO", "manTx": "Ankunft", "ori": "N", "polyS": 11, "polyE": 12 },
          { "man": "NO", "manTx": "Zugang B Unter den Linden Pariser Platz, Treppe zum Zwischengeschoss", "ori": "U" }
        ],
        "polylineGroup": { "polylineDesc": [ { "dim": 2, "delta": false,
          "crd": [13.3777, 52.5163, 13.377704, 52.51627, 13.377752, 52.516273, "…"] } ] }
      }
    } ] }
  } ]
}

man ist der Manövertyp, manTx der Anzeigetext, ori die Himmelsrichtung (N, E, … sowie U/D für Ebenenwechsel). polyS/polyE verweisen auf Indizes in der Polylinie. Neu in 2.52: Segmente können eigene Notes tragen, etwa zu Zugängen.

journeypos: Fahrzeugpositionen

GET/latest/journeypos

Liefert Fahrzeuge, die sich in einem Kartenausschnitt (Bounding Box) befinden, mit Position, Fahrtverlauf und interpolierter Bewegung. Typischer Einsatz: Live-Karten.

ParameterTypStandardBeschreibung
llLat, llLon Pflichtdouble–Untere linke Ecke der Box.
urLat, urLon Pflichtdouble–Obere rechte Ecke der Box.
positionModeenumREPORT_ONLYREPORT_ONLY nur gemeldete GPS-Positionen · CALC_REPORT gemeldet, sonst berechnet · CALC alle Positionen aus dem Fahrplan berechnet.
maxJnyint1000Maximale Anzahl Fahrzeuge, 1–1000.
date, timestringjetztBezugszeitpunkt.
periodSizeint30000Vorschauzeitraum für Bewegungen in Millisekunden.
periodStepint2000Schrittweite der Bewegungspunkte in Millisekunden.
products, lines, globallineids neu, operators, attributes, infotexts, jidstring–Filter nach Produkt, Linie, Unternehmen, Attributen, Infotexten oder Fahrt-ID.
Beispielanfrage: S-Bahnen in Berlin-Mitte
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/journeypos?accessId=$ACCESS_ID&llLat=52.51&llLon=13.39&urLat=52.53&urLon=13.42&products=1&positionMode=CALC&maxJny=50&format=json"
Beispielantwort (gekürzt)
{
  "Journey": [ {
    "name": "S3",
    "direction": "S Spandau Bhf (Berlin)",
    "lon": 13.400831, "lat": 52.522407,
    "trainCategory": "S-4",
    "JourneyDetailRef": { "ref": "1|1954|5|86|3112026" },
    "Product": { "name": "S3", "catOut": "S", "lineId": "de:VBB:11000000|S-Bahn|S3:S3-B" },
    "JourneyPath": { "JourneyPathItem": [
      { "progressInTime": 0,    "progressInPercent": 10, "dirGeo": 16, "state": "O",
        "fromLocationId": "A=1@O=S Hackescher Markt (Berlin)@…@L=300212074@",
        "toLocationId":   "A=1@O=S+U Friedrichstr. Bhf (Berlin)@…@L=300005466@" },
      { "progressInTime": 2000, "progressInPercent": 11, "dirGeo": 16, "state": "O" }
    ] },
    "Stops": { "Stop": [ { "name": "S Erkner Bhf", "depTime": "09:14:00" }, "…" ] }
  } ],
  "planningPeriodBegin": "2026-10-25",
  "planningPeriodEnd": "2027-12-11"
}

Leere Antwort im Standardmodus. Mit positionMode=REPORT_ONLY (Standard) erscheinen nur Fahrzeuge, die aktiv GPS-Positionen melden; das Ergebnis kann dann leer sein. Für eine vollständige Karte CALC_REPORT verwenden.

Rufen Sie den Service für Live-Karten höchstens alle 15–30 Sekunden auf und animieren Sie dazwischen clientseitig über JourneyPath.

himsearch: Störungs- und Baustellenmeldungen

GET/latest/himsearch

Durchsucht die HAFAS-Informations-Manager-Meldungen (HIM): Bauarbeiten, Störungen, Umleitungen, Hinweise zu Haltestellen und Linien.

ParameterTypStandardBeschreibung
Zeitraum
dateB, timeBstring–Beginn des Ereigniszeitraums (YYYY-MM-DD, hh:mm).
dateE, timeEstring–Ende des Ereigniszeitraums.
weekdaysstring–Bitmaske der Wochentage ab Montag, z. B. 1111100.
Betroffene Objekte
lines, lineids, globallineids neustring–Meldungen zu diesen Linien.
stationsstring–Meldungen zu diesen Haltestellen-IDs.
fromstation, tostation, bothwaysstring / bool–Meldungen zu einem Streckenabschnitt, optional in beiden Richtungen.
operators, companiesstring–Unternehmen bzw. meldende Stelle (! schließt aus).
categories, trainnamesstring–Zuggattungen, Zugnamen.
llLat, llLon, urLat, urLondouble–Bounding Box.
regionsstring–Regionen aus datainfo.
Meldungsart
himIdsstring–Bestimmte Meldungen per ID.
himcategorystring–Kategorie, z. B. Baustelle oder Störung (Werte installationsabhängig).
channelsstring–Ausgabekanäle, z. B. TIMETABLE, HIM_STATION_MONITOR.
minprio, maxprioint–Prioritätsbereich.
himtext, exthimtextstring–Freitextsuche.
himtags, himtexttags, metas, additionalfields, extInfo, searchmodestring–Erweiterte Filter (installationsabhängig).
Ausgabe
orderBystring–EVT_BEG_ASC, EVT_BEG_DESC, EVT_END_ASC/DESC, PRIO_ASC/DESC, LMOD_ASC/DESC, HID_ASC/DESC, kommagetrennt kombinierbar.
hierarchicalViewboolfalseÜbergeordnete Meldungen mit Unterelementen.
affectedJourneyMode, affectedJourneyStopModestring–Ausgabe betroffener Fahrten und ihrer Halte.
poly, polyEncfalseGeometrie betroffener Abschnitte.
Beispielanfrage: Meldungen zur S3 im November
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/himsearch?accessId=$ACCESS_ID&lines=S3&dateB=2026-11-03&dateE=2026-11-30&orderBy=PRIO_DESC&format=json"
Beispielantwort (gekürzt, eine Meldung)
{
  "Message": [ {
    "id": "HIM_FREETEXT_351247",
    "act": true,
    "head": "Bauarbeiten.",
    "text": "Der Zug fällt zwischen Bad Schandau und Schöna aus. Bitte prüfen Sie Ihre Reiseverbindung kurz vor der Abfahrt des Zuges.",
    "company": "VBB",
    "category": "1",
    "messageCategory": [ { "id": 1, "name": "Baustelle" } ],
    "priority": 5,
    "icon": "him_gen_constr",
    "sDate": "2026-11-03", "sTime": "06:47:00",
    "eDate": "2026-11-05", "eTime": "19:25:00",
    "modDate": "2026-07-21", "modTime": "22:08:42",
    "channel": [ { "name": "TIMETABLE", "validFromDate": "2026-07-21", "validToDate": "2026-11-05" } ],
    "affectedProduct": [ { "name": "S3", "cls": "1", "operatorCode": "DBS" } ],
    "affectedStops": { "StopLocation": [ { "extId": "900245026", "name": "Dahlewitz, Bahnhof" } ] },
    "event": [ { "sDate": "2026-10-25", "eDate": "2026-11-05", "sTime": "06:47:00", "eTime": "19:25:00" } ]
  } ]
}

Datenstand vor der Umstellung. Bis zum Wechsel am 30.11.2026 liefert himsearch nur eine Testmeldung. Die produktiven Störungsmeldungen werden zum Wechsel angeschlossen. Bis dahin liefert eine Anfrage wie oben im neuen System keine solchen Meldungen.

Immer filtern. Eine Anfrage ohne Filter liefert sämtliche aktiven Meldungen und kann mehrere Megabyte groß werden. Schränken Sie mindestens nach Linie, Haltestelle, Zeitraum oder Bounding Box ein.

datainfo: Stammdaten der Installation neu

GET/latest/datainfo

Liefert die Stammdaten, die Sie für Filter und Darstellung brauchen: Verkehrsunternehmen, Produkte mit Farben, Produktkategorien, Regionen sowie die Fahrplanperiode. Keine weiteren Parameter außer den allgemeinen.

Beispielanfrage
curl "https://vbb.hafas.cloud/api/fahrinfo/latest/datainfo?accessId=$ACCESS_ID&format=json"
Beispielantwort (gekürzt)
{
  "Operator": [
    { "id": "796", "name": "Berliner Verkehrsbetriebe", "nameS": "BVG", "nameN": "BVG",
      "url": "https://www.bvg.de/", "administration": ["BVB---", "BVF---", "BVT---", "BVU---"] },
    { "id": "1", "name": "S-Bahn Berlin GmbH", "nameS": "DBS", "url": "https://sbahn.berlin/" }
  ],
  "Product": [
    { "name": "S-Bahn", "cls": "1", "catOut": "S", "catIn": "S-5", "catOutL": "S",
      "icon": { "res": "prod_gen", "backgroundColor": { "hex": "#37874A" }, "foregroundColor": { "hex": "#FFFFFF" } } }
  ],
  "ProductCategory": [ { "name": "S-Bahn", "cls": "1", "Product": [ … ] } ],
  "Region": [ { "name": "DRT_BVG__N95", "extId": 1000 } ],
  "begin": "2026-10-25",
  "end": "2027-12-11",
  "serverVersion": "2.52.1",
  "dialectVersion": "2.52"
}

Die Daten ändern sich selten. Laden Sie sie beim Start Ihrer Anwendung und cachen Sie sie für einen Tag.

wadl und xsd: Maschinenlesbare Beschreibung

Für jeden Service steht eine WADL-Beschreibung aller Parameter bereit, für die Antwortstrukturen ein XML-Schema. Beide sind ohne Zugangskennung abrufbar und eignen sich zur Code-Generierung und zur Prüfung von Parameternamen.

RessourceURL
Übersicht aller Serviceshttps://vbb.hafas.cloud/api/fahrinfo/latest/
WADL eines Servicehttps://vbb.hafas.cloud/api/fahrinfo/latest/{service}?wadl, z. B. …/trip?wadl
XML-Schemahttps://vbb.hafas.cloud/api/fahrinfo/latest/xsd/rest-2.52.xsd

Die Service-Namen in der WADL-URL entsprechen den Pfaden: arrivalBoard, datainfo, departureBoard, gisroute, himsearch, journeyDetail, journeypos, location.nearbystops, location.name, trip. Jeder Parameter trägt in der WADL die Versionsnummer, seit der er existiert.


Fehlerbehandlung

Fehler werden als Objekt mit errorCode und errorText geliefert. Fehler aus der Fahrplanberechnung enthalten zusätzlich internalErrorCode und einen anzeigefähigen Text internalErrorTextOut.

Beispiel: unbekannte Haltestelle
HTTP/1.1 400 Bad Request
Content-Type: application/json; charset=UTF-8

{
  "serverVersion": "2.52.1",
  "dialectVersion": "2.52",
  "errorCode": "SVC_LOC",
  "errorText": "location missing or invalid (LOCATION).",
  "internalErrorCode": "LOCATION",
  "internalErrorText": "HCI Service: location missing or invalid",
  "internalErrorTextOut": "Während der Suche ist ein interner Fehler aufgetreten",
  "requestId": "default-request-id"
}
errorCodeHTTPBedeutungWas tun?
API_AUTH401Kennung ungültig, gesperrt oder für den Service nicht freigeschaltetKennung prüfen, ggf. Freischaltung bei api@vbb.de anfragen
API_PARAM400Pflichtparameter fehlt oder Wert außerhalb des erlaubten BereichserrorText nennt den Parameter
SVC_PARAM400Parameter fachlich ungültig, z. B. abgelaufene FahrtreferenzReferenz neu abrufen
SVC_LOC400Ort unbekannt oder ungültigID über location.name prüfen
SVC_LOC_DEP / SVC_LOC_ARR400Start bzw. Ziel fehlt oder ist ungültigStart-/Zielparameter prüfen
SVC_DATATIME_PERIOD400Datum außerhalb der FahrplanperiodePeriode über datainfo ermitteln
SVC_DATATIME400Datum/Zeit fehlt oder ist ungültig, auch bei unlesbarem ctx in gisrouteKontext frisch aus trip holen
SVC_NO_RESULT200Anfrage gültig, aber keine Verbindung gefundenHinweis anzeigen, Suche anpassen
(ohne)5xxServer- oder Gateway-FehlerMit Backoff wiederholen

Drei Stolperfallen.

  • SVC_NO_RESULT kommt mit HTTP 200. Prüfen Sie bei jeder Antwort, ob errorCode gesetzt ist, nicht nur den Statuscode.
  • Fehler, die vor der Auswertung von format entstehen (fehlende Kennung, ungültiger format-Wert), kommen als XML, auch wenn JSON angefordert wurde. Werten Sie den Content-Type aus, bevor Sie parsen, oder senden Sie zusätzlich Accept: application/json.
  • Eine leere Ergebnisliste ist kein Fehler: Eine Tafel ohne Abfahrten liefert einfach kein Departure-Feld.
  • Ein ungültiger Blätter-Kontext (context in trip) wird ohne Fehlermeldung ignoriert; Sie erhalten dann eine neue Suche ab jetzt statt der erwarteten späteren Verbindungen.

Gute Praxis

  • Kennung serverseitig halten. Bauen Sie einen schlanken Proxy, der die accessId ergänzt und Antworten cacht.
  • Caching. datainfo: 24 h. Haltestellensuche: Stunden. Abfahrtstafeln: höchstens 30 s. Verbindungen: nicht über die Sitzung hinaus.
  • Autovervollständigung drosseln. Senden Sie location.name erst ab drei Zeichen und mit 250–300 ms Verzögerung nach dem letzten Tastendruck; nutzen Sie withProducts=0.
  • Antworten klein halten. maxJourneys, maxNo, passlist=0 und polyEnc=GPA reduzieren Datenmenge und Antwortzeit.
  • Gzip aktivieren (Accept-Encoding: gzip).
  • IDs richtig speichern. Haltestellen über mainMastExtId oder DHID, nie über Namen oder den Lid-String. Referenzen (JourneyDetailRef, ctxRecon, GisRef, scrF/scrB) als undurchsichtige, kurzlebige Werte behandeln.
  • Tolerant parsen. Neue Felder können jederzeit hinzukommen, optionale Felder fehlen. Listen sind in JSON immer Arrays.
  • Wiederholungen mit Backoff. Bei 5xx-Antworten oder Timeouts höchstens zweimal mit wachsendem Abstand wiederholen, bei 4xx nicht.
  • Vereinbarte Anfragelimits einhalten. Cachen und drosseln Sie so, dass Ihre Anwendung auch in Spitzenzeiten innerhalb der für Ihre Kennung vereinbarten Menge bleibt. Bei übermäßiger Belastung kann der VBB den Zugang vorübergehend deaktivieren.
  • Netzweite Echtzeit über GTFS-RT. Fragen Sie nicht viele Tafeln oder Fahrten in Schleifen ab, um ein Gesamtbild des Netzes zu bekommen. Dafür ist der GTFS-RT-Feed gedacht.
  • requestId setzen und zusammen mit dem Response-Header X-Request-ID loggen. Geben Sie bei Supportanfragen an api@vbb.de beide Werte, die vollständige Anfrage-URL ohne accessId und den Zeitpunkt an.
  • Quellenangabe. Nennen Sie den VBB als Quelle der Fahrplandaten, zum Beispiel in den AGB oder im Impressum Ihrer Anwendung. Das ist eine der Bedingungen für den Zugang zum Produktivsystem.
  • Mit Ausfällen rechnen. Es gibt keinen Anspruch auf unterbrechungsfreie Verfügbarkeit. Zeigen Sie bei Fehlern oder Timeouts einen verständlichen Hinweis an, statt die Anwendung abstürzen zu lassen, und greifen Sie, wo es passt, auf zwischengespeicherte Solldaten zurück.

Changelog: 2.49 → 2.52

2.49.5 → 2.52.1Umstellung am 30.11.2026

Die bisherige Schnittstelle unter https://fahrinfo.vbb.de/restproxy/latest (Version 2.49) wird am 30.11.2026 durch https://vbb.hafas.cloud/api/fahrinfo/latest (Version 2.52) ersetzt. Stellen Sie Ihre Anwendung bis zu diesem Datum um; die neue Schnittstelle ist bereits jetzt erreichbar. Pfade, Service-Namen und die meisten Parameter bleiben gleich, die Zugangskennung gilt weiter. Grundlage dieses Changelogs ist ein Vergleich der WADL- und XSD-Beschreibungen beider Versionen sowie paralleler Abfragen am 03.11.2026.

Breaking Changes

  • geändert
    Basis-URL. fahrinfo.vbb.de/restproxy/latest → vbb.hafas.cloud/api/fahrinfo/latest.
  • geändert
    Haltepunkt-IDs in Antworten. stopExtId an Abfahrten und Ankünften, extId an Halten, Fahrtabschnitten und in location.nearbystops enthalten jetzt Haltepunkt-IDs (300…) statt Haltestellen-IDs (900…). Die Haltestelle steht in den neuen Feldern mainMastExtId / mainMast. Code, der stopExtId mit gespeicherten 900er-IDs vergleicht, muss auf mainMastExtId umgestellt werden. Als Eingabe bleiben 900er-IDs gültig.
  • geändert
    Haltestellenstruktur in den Daten. Tram- und Bushaltestellen an großen Knoten sind eigenständige Haltestellen. Beispiel Alexanderplatz: products sinkt von 79 auf 67 (nur S, U, Regionalverkehr); Tram und Bus liegen an 900100005, 900100031 usw. Die Abfahrtstafel einer Haltestelle enthält diese weiterhin.
  • entfernt
    JSONP. format=jsonp und jsonpCallback werden nicht mehr unterstützt (400 API_PARAM). Verwenden Sie format=json mit CORS.
  • geändert
    Notes-Schlüssel. Ausstattungsattribute haben neue Schlüssel: Rolltreppe FT → RO, Aufzug AT → AU. Weitere Schlüssel sind entfallen oder hinzugekommen (siehe Hinweise). Wer auf Schlüssel filtert, muss die Zuordnung prüfen.
  • geändert
    Referenzen und Kontexte. JourneyDetailRef.ref, ctxRecon, GisRef.ref und scrB/scrF aus 2.49 sind im neuen System ungültig. Das Format hat sich teils geändert (z. B. Suffix |C:B an Fahrtreferenzen aus trip, Präfix ¶G|/¶H| an GisRef, ¬¶BAIM¶… an ctxRecon). Gespeicherte Verbindungen müssen nach der Umstellung neu gesucht werden.
  • geändert
    Adressnamen. Adress-Treffer enthalten keine Postleitzahl mehr: „Karl-Marx-Allee 1, 10178 Berlin-Mitte“ → „Karl-Marx-Allee 1, Berlin-Mitte“.

Neu

  • neu
    Service datainfo mit Unternehmen, Produkten, Farben, Kategorien, Regionen und Fahrplanperiode. In 2.49 nicht verfügbar.
  • neu
    Parameter globallineids in departureBoard, arrivalBoard, trip, journeypos, himsearch (Filter nach globaler Linien-ID mit Typpräfix A×).
  • neu
    Parameter operators in location.name.
  • neu
    Parameter duration in location.nearbystops (Verfügbarkeitszeitraum, 1–40320 min).
  • neu
    Haltestellen-Hierarchie: Felder hasMainMast, isMainMast, mainMast, mainMastId, mainMastExtId, mainMastAltId, mainMastLat, mainMastLon an Orten, Abfahrten, Ankünften und Abschnitten.
  • neu
    LineInfo mit GlobalIds[] und lineId an allen Produkten.
  • neu
    equivalentStopLocation[] in location.name (gleichwertige Haltestellen eines Knotens).
  • neu
    Steiginformationen: Hinweise Nd, Ne, Nf, Nu, NF (Steigbezeichnung de/en), SP (Position), LV (Ebene); DHID auf Steigebene in altId.
  • neu
    Umstiegswege: Umstiege zwischen Steigen eines Bahnhofs erscheinen als eigener WALK-Abschnitt; Abschnitte tragen minimumChangeDuration.
  • neu
    Zugangsinformationen als Notes an GisRoute.seg[] (z. B. „Zugang B Unter den Linden Pariser Platz, Treppe zum Zwischengeschoss“).
  • neu
    Weitere Felder: entry an Abfahrten/Ankünften, checksumDti und checksumSave an Verbindungen.
  • neu
    Schema-Erweiterungen (XSD 2.52, noch nicht in allen Antworten befüllt): globalId an Fahrten, Abschnitten und Unternehmen; OriginStop/DestinationStop an Abfahrten und Ankünften; Auslastung mit Status L/M/H/U/NA und Echtzeitwerten (sRt, vRt, rawRt); Geo-Feature-Typen GEO_REGION, PARKING_ZONE.
  • neu
    HTTP: Response-Header X-Request-ID; POST wird angenommen (2.49: 405).

Entfernt

  • entfernt
    format=jsonp, jsonpCallback (alle Services).
  • entfernt
    requestId in jeder Antwort. 2.49 lieferte immer eine generierte requestId. 2.52 liefert sie nur noch, wenn Sie selbst requestId mitsenden; zur Nachverfolgung dient der Header X-Request-ID.
  • entfernt
    Occupancy (Auslastung FIRST/SECOND mit raw) ist in Tafeln, Verbindungen, Fahrtverläufen und Fahrzeugpositionen derzeit nicht enthalten; die Anbindung ist voraussichtlich zum Wechsel vorgesehen. Siehe offene Punkte.
  • entfernt
    rtPlatform/rtTrack an Ankünften in Stichproben nicht mehr enthalten; Sollgleis track/platform bleibt.
  • entfernt
    Technische Meldung backendInfo in TechnicalMessages.
  • entfernt
    gisroute: Trip.duration, Trip.dist, Trip.ctxRecon, Trip.checksum, TripStatus sowie edgeHashR/edgeHashS auf Trip-Ebene; Dauer und Distanz stehen weiterhin am Abschnitt (Leg.duration, Leg.dist).

Geändertes Verhalten

  • geändert
    Umgebungssuche. location.nearbystops liefert Haltepunkte statt Haltestellen und in Stichproben deutlich weniger Treffer als 2.49 (Alexanderplatz, 500 m: 2 statt 10 Treffer). Der Fehler ist gemeldet und wird behoben; siehe offene Punkte.
  • geändert
    Verspätete Fahrten auf Tafeln. Abfahrten mit Sollzeit vor dem Anfragezeitpunkt, deren Echtzeit danach liegt, werden aufgenommen.
  • geändert
    Treffer und Ranking in location.name unterscheiden sich durch die neue Haltestellenstruktur (andere weight-Werte, andere Reihenfolge).
  • geändert
    Koordinatennamen in trip: originCoordName/destCoordName wird übernommen; 2.49 ersetzte ihn häufig durch einen nahegelegenen POI („Berlin, Brandenburger Tor“).
  • geändert
    Fehlerantworten bei fehlender Kennung oder ungültigem format kommen als XML, auch bei format=json.
  • geändert
    Übersichtsseite. 2.49 lieferte für unbekannte Pfade (z. B. /wadl, /datainfo) die Service-Übersicht als HTML mit Status 200. 2.52 antwortet auf unbekannte Pfade mit 404; die Übersicht liegt unter /latest/, die WADL je Service unter /{service}?wadl.

Offene Punkte (Stand 03.11.2026)

  • Störungsmeldungen: himsearch liefert im neuen System derzeit nur eine Testmeldung (2.49: 862 aktive Meldungen). Die produktiven Meldungen werden zum Wechsel am 30.11.2026 angeschlossen.
  • Umgebungssuche: location.nearbystops liefert unabhängig von r nur Haltepunkte der nächstgelegenen Haltestelle, an manchen Koordinaten kein Ergebnis. Der Fehler ist gemeldet und wird behoben.
  • Auslastung: Auslastungsdaten (Occupancy) fehlen derzeit. Sie werden voraussichtlich ebenfalls zum Wechsel am 30.11.2026 angeschlossen.

Migrations-Checkliste

  1. Basis-URL austauschen. Die accessId bleibt gleich.
  2. JSONP-Aufrufe auf format=json umstellen (CORS ist aktiv).
  3. Überall, wo Sie Haltestellen aus Antworten mit gespeicherten IDs vergleichen, mainMastExtId statt stopExtId/extId verwenden (Fallback auf extId, wenn hasMainMast fehlt).
  4. Ergebnisse von location.nearbystops nach mainMastExtId gruppieren.
  5. Auswertungen von Notes-Schlüsseln (FT, AT …) auf die neuen Schlüssel prüfen.
  6. Gespeicherte ctxRecon, Fahrtreferenzen und Blätter-Kontexte verwerfen und neu erzeugen.
  7. Abhängigkeiten von requestId in Antworten und backendInfo entfernen. Occupancy als optional behandeln, bis die Auslastung angeschlossen ist.
  8. Fehlerbehandlung um Content-Type-Prüfung ergänzen (XML-Fehler bei JSON-Anfragen).
  9. Optional: Linienfilter auf globallineids umstellen, Stammdaten über datainfo laden statt hart zu kodieren.
  10. Alte und neue Schnittstelle parallel abfragen und Ergebnisse vergleichen, bevor Sie umschalten.
  11. Spätestens am 30.11.2026 produktiv auf die neue Basis-URL umschalten.

Fragen zur Umstellung richten Sie an api@vbb.de.

VBB Fahrinfo-API, HAFAS ReST 2.52 · Dokumentationsstand 03.11.2026 · Kontakt: api@vbb.de · Diese Dokumentation steht unter CC BY 4.0 (Quellenangabe: „VBB Fahrinfo-API – Dokumentation, VBB, CC BY 4.0“), die Code-Beispiele unter CC0 1.0. · Die Beispielantworten stammen aus Live-Abfragen und sind gekürzt; Zeiten und IDs ändern sich mit dem Fahrplan.