vrr-efa-api

name	vrr-efa-api
description	Live-Fahrplanauskunft für den VRR (Verkehrsverbund Rhein-Ruhr) via EFA API. Abfahrten, Verbindungen, Haltestellen -- Echtzeit, kostenlos, kein API Key. Use when: user asks for train/bus/tram connections, departures, or transit info in NRW/Ruhrgebiet. Also works for DB Regionalverkehr in the region.
metadata	{"category":"research","author":"ManniTheRaccoon","version":"1.0"}
compatibility	Requires curl, jq. No API key needed.

VRR Fahrplan 🚂

Live-Fahrplanauskunft für Bus & Bahn im Rhein-Ruhr-Gebiet. Echtzeit-Daten, kostenlos, kein Key.

Base URL: https://efa.vrr.de/vrr

Quick Reports

Verbindung A → B

curl -sf "https://efa.vrr.de/vrr/XML_TRIP_REQUEST2?outputFormat=rapidJSON&type_origin=stop&name_origin=ORIGIN&type_destination=stop&name_destination=DEST&useRealtime=1&itdTripDateTimeDepArr=dep" \
| jq -r '
  .journeys[:6][] |
  .legs[0] as $first | .legs[-1] as $last |
  ($first.origin.departureTimePlanned // "")[11:16] as $dep |
  ($first.origin.departureTimeEstimated // "")[11:16] as $dep_est |
  ($last.destination.arrivalTimePlanned // "")[11:16] as $arr |
  ($first.transportation.product.name // "") + " " + ($first.transportation.disassembledName // "") |
  ltrimstr(" ") as $line |
  ($first.origin.properties.platformName // "?") as $gl |
  (if $dep_est != "" and $dep_est != $dep then " (+" + (($dep_est[3:5] | tonumber) - ($dep[3:5] | tonumber) | tostring) + ")" else "" end) as $delay |
  "\($dep)\($delay) | Gl. \($gl) | \($line) → an \($arr)"
'

Beispiel: name_origin=Dortmund%20Hbf&name_destination=Bochum%20Hbf

Output:

11:45 (+1) | Gl. 16 | Regionalzug RE1 → an 11:54
11:53 | Gl. 7 | S-Bahn S1 → an 12:16
12:07 | Gl. 16 | Regionalzug RE6 → an 12:18

Abfahrtstafel (nächste Abfahrten ab Haltestelle)

curl -sf "https://efa.vrr.de/vrr/XML_DM_REQUEST?outputFormat=rapidJSON&type_dm=stop&name_dm=HALTESTELLE&mode=direct&useRealtime=1" \
| jq -r '
  .stopEvents[:10][] |
  (.departureTimePlanned // "")[11:16] as $dep |
  (.departureTimeEstimated // "")[11:16] as $dep_est |
  (.transportation.disassembledName // .transportation.name // "?") as $line |
  (.transportation.destination.name // "?") as $dest |
  (.location.properties.platformName // "?") as $gl |
  (if $dep_est != "" and $dep_est != $dep then " (+" + (($dep_est[3:5] | tonumber) - ($dep[3:5] | tonumber) | tostring) + ")" else "" end) as $delay |
  "\($dep)\($delay) | Gl. \($gl) | \($line) → \($dest)"
'

Beispiel: name_dm=Essen%20Hbf

Output:

11:37 (+4) | Gl. 3 | 105 → Finefraustr.
11:38 (+3) | Gl. 1 | U11 → Gelsenkirchen
11:40 (+9) | Gl. 8 | RE2 → Osnabrück Hbf

Haltestelle suchen

curl -sf "https://efa.vrr.de/vrr/XML_STOPFINDER_REQUEST?outputFormat=rapidJSON&type_sf=any&name_sf=SUCHBEGRIFF" \
| jq -r '.locations[:5][] | "\(.name) [\(.type)] id:\(.id)"'

Beispiel: name_sf=Dortmund%20Signal

Output:

Dortmund Signal Iduna Park [stop] id:de:05913:8610

API Endpoints

Endpoint	Zweck
XML_TRIP_REQUEST2	Verbindungssuche A → B
XML_DM_REQUEST	Abfahrtstafel einer Haltestelle
XML_STOPFINDER_REQUEST	Haltestelle suchen

Wichtige Parameter

Verbindungssuche (TRIP_REQUEST)

Parameter	Wert	Beschreibung
outputFormat	rapidJSON	JSON-Output
type_origin	stop	Typ der Starthaltestelle
name_origin	z.B. Dortmund Hbf	Name der Starthaltestelle
type_destination	stop	Typ der Zielhaltestelle
name_destination	z.B. Bochum Hbf	Name der Zielhaltestelle
useRealtime	1	Echtzeit-Daten einbeziehen
itdTripDateTimeDepArr	dep / arr	Abfahrt oder Ankunft
itdDateDay	31	Tag (optional, default: jetzt)
itdDateMonth	3	Monat
itdDateYear	2026	Jahr
itdTimeHour	14	Stunde
itdTimeMinute	30	Minute

Abfahrtstafel (DM_REQUEST)

Parameter	Wert	Beschreibung
outputFormat	rapidJSON	JSON-Output
type_dm	stop	Haltestellentyp
name_dm	z.B. Essen Hbf	Haltestellenname
mode	direct	Nur direkte Abfahrten
useRealtime	1	Echtzeit
limit	10	Max. Ergebnisse

Response-Struktur

Verbindung (Journey)

journey.legs[0].origin.departureTimePlanned     → "2026-03-31T09:45:00Z" (UTC!)
journey.legs[0].origin.departureTimeEstimated    → "2026-03-31T09:46:30Z" (mit Verspätung)
journey.legs[0].origin.properties.platformName   → "16" (Gleis)
journey.legs[0].transportation.product.name      → "Regionalzug"
journey.legs[0].transportation.disassembledName  → "RE1"
journey.legs[-1].destination.arrivalTimePlanned   → "2026-03-31T09:54:00Z"

Abfahrt (StopEvent)

stopEvent.departureTimePlanned                   → "2026-03-31T09:37:00Z" (UTC!)
stopEvent.departureTimeEstimated                 → "2026-03-31T09:41:24Z"
stopEvent.transportation.disassembledName        → "105"
stopEvent.transportation.destination.name        → "Essen Finefraustr."
stopEvent.location.properties.platformName       → "3"

⚠️ Wichtige Hinweise

• Zeiten sind UTC! Für deutsche Ortszeit +1h (MEZ) oder +2h (MESZ) addieren
• URL-Encoding: Leerzeichen und Umlaute encoden (%20, %C3%BC etc.)
• Kein API Key nötig -- öffentliche API, aber Fair Use beachten
• Abdeckung: Primär VRR (Ruhrgebiet, Rheinland, Wuppertal), aber auch DB Fernverkehr und angrenzende Verbünde werden angezeigt
• Haltestellen-Format: Stadt Haltestelle (z.B. Dortmund Hbf, Essen Hauptbahnhof)

Formatting für Chat

Wenn du Ergebnisse an den User sendest:

Verbindung:

🚂 **11:45** (+1) | **Gl. 16** | RE1 → an 11:54
🚋 **11:53** | **Gl. 7** | S1 → an 12:16

Abfahrtstafel:

📋 Abfahrten Essen Hbf:
🚋 11:37 (+4) | Gl. 3 | 105 → Finefraustr.
🚇 11:38 (+3) | Gl. 1 | U11 → Gelsenkirchen

Icons nach Verkehrsmittel:

• 🚂 Regionalzug (RE, RB)
• 🚄 Fernverkehr (IC, ICE)
• 🚇 U-Bahn
• 🚋 Straßenbahn / S-Bahn
• 🚌 Bus
• 🚶 Fußweg (Umstieg)

---

v1.0 -- VRR EFA API Skill. ManniTheRaccoon 2026-03-31. 🚂