Endpunkte - ÖffiGo

GET /v1/health

Kurzer Lebenszeichen-Check für Monitoring: 200, solange der Dienst gesund ist, sonst 503.

curl -s https://api.oeffigo.app/v1/health

GET /v1/status

Betriebszustand aller Komponenten – dieselbe Grundlage wie status.oeffigo.app.

curl -s https://api.oeffigo.app/v1/status

{
  "generatedAt": "2026-07-26T13:25:06.754Z",
  "overall": "operational",
  "components": [
    { "id": "api", "name": "…", "status": "operational" }
  ]
}

GET /v1/history

Pünktlichkeits-Auswertung aus offiziellen Ist-Zeiten: Summen, Tagesverlauf, Linien und ein Wochentag×Stunde-Muster. Gezählt werden einzelne Halte, nicht ganze Fahrten. Ausfälle stammen nur aus ausdrücklichen Meldungen – ein fehlender Datenpunkt gilt nie als Ausfall.

ISO-Datum

Beginn des Zeitraums.

ISO-Datum

Ende des Zeitraums. Höchstens 366 Tage Spanne.

string

Auf eine Linie einschränken, z. B. U1.

string

Auf eine Datenquelle einschränken: wiener_linien, trias, stmk_gtfs_rt.

curl -s "https://api.oeffigo.app/v1/history?from=2026-07-15&to=2026-07-26&line=U1"

{
  "period": { "from": "2026-07-15", "to": "2026-07-26" },
  "totals": { "onTimeShare": 0.9556, "avgDelayMin": 0.57, "late10Share": 0.007 },
  "officialRealtime": {
    "daily": [ { "day": "2026-07-26", "events": 18109, "on_time_pct": 97.4 } ],
    "lines": [ { "line": "U1", "events": 39970, "on_time_pct": 96 } ],
    "heatmap": [ { "dow": 1, "hour": 8, "avg_delay_min": 0.6 } ]
  }
}

dow ist ISO: 1 = Montag … 7 = Sonntag.

GET /v1/punctuality

Pünktlichkeit je Linie der letzten 30 Tage, dieselben Zahlen wie in der App und auf oeffigo.app/puenktlichkeit. Neu gerechnet wird jede Nacht, through nennt den letzten Messtag.

string

Zum Beispiel wien, steiermark, kaernten.

string

Verkehrsmittel, etwa tram, bus, metro, s_bahn.

string

Freitext über Linie und Strecke, höchstens 80 Zeichen.

int

Standard:"2000, 0"

Seitenweise lesen.

curl -s "https://api.oeffigo.app/v1/punctuality?region=steiermark&mode=tram&limit=1"

{
  "through": "2026-10-26",
  "total": 922,
  "matched": 14,
  "lines": [
    {
      "slug": "steiermark/4",
      "name": "4",
      "mode": "tram",
      "operator": "Graz Linien",
      "route": "Liebenau Murpark – Reininghaus",
      "last30": { "trips": 3287, "realtimeShare": 0.9147, "onTimeShare": 0.8463, "avgDelaySec": 64 }
    }
  ]
}

Pünktlich heißt höchstens 1 min zu früh und höchstens 3 min zu spät. Linien ohne Echtzeit tragen keinen Anteil.

Weitere Pünktlichkeits-Endpunkte

Endpunkt	Was er liefert
`GET /v1/punctuality/line?slug=wien/u6`	Eine Linie mit Fenstern über 7, 30 und 90 Tage, Strecke, Stunden und auffälligen Fahrten
`GET /v1/punctuality/stops`	Haltestellen mit gemessener Pünktlichkeit, mit `region`, `q`, `limit`, `offset`
`GET /v1/punctuality/stop?slug=…`	Alle Linien an einer Haltestelle
`GET /v1/punctuality/overview`	Gesamt, je Region und Verkehrsmittel
`GET /v1/punctuality/search?q=S5`	Suche über Linien, Haltestellen und Zugnummern, höchstens 25 Treffer
`GET /v1/punctuality/coverage`	Wie viel des Fahrplans gemessen ist

Datenquellen: Stadt Wien – data.wien.gv.at (CC BY 4.0), Mobilitätsverbünde Österreich OG, ÖBB-Infrastruktur AG und ÖBB-Personenverkehr AG (CC BY 4.0). Bitte nenn sie, wenn du die Zahlen zeigst (Namensnennung).

GET /v1/disruptions/archive

Aktuelle und vergangene Störungsmeldungen der Verkehrsbetriebe, neueste zuerst. Auch beendete Meldungen bleiben abrufbar.

string

Nur Meldungen zu einer Linie.

string

Bundesland in Kleinbuchstaben ohne Umlaute, etwa steiermark oder niederoesterreich.

string

Quelle der Meldung, etwa ims (Mobilitätsverbünde) oder wl (Wiener Linien).

string

Freitext, höchstens 80 Zeichen.

string

Zeitraum als ISO-Zeitpunkt.

int

Standard:"50, 0"

Höchstens 200 je Seite.

curl -s "https://api.oeffigo.app/v1/disruptions/archive?limit=1"

{
  "total": 666,
  "items": [
    {
      "id": "HIM_FREETEXT_537924",
      "source": "ims",
      "kind": "disruption",
      "title": "Teilausfall",
      "operator": "ÖBB",
      "category": "Störung",
      "activeWindows": [{ "from": "2026-10-27T22:18:00+01:00", "to": "2026-10-27T22:25:00+01:00" }]
    }
  ]
}

Eine einzelne Meldung holst du mit GET /v1/disruptions/archive/item?id=…&source=….

GET /v1/predictions Pausiert

ÖffiGos eigene Verspätungsprognosen. Nur Einträge mit hoher oder mittlerer Sicherheit; kein Eintrag ist älter als acht Minuten.

Pausiert, in Entwicklung. Die Endpunkte antworten, liefern aber derzeit eine leere Liste. Ob Prognosen verfügbar sind, meldet GET /v1/status in measurement.predictionsAvailable.

Ein Filter ist Pflicht. Ohne lat+lon, line, jid oder jids antwortet der Endpunkt mit 400 missing_query.

number

Umkreissuche, optional mit radius.

string

Linienbezeichnung, z. B. U1.

string

Eine Fahrt-Referenz.

string[]

Bis zu 40 Fahrt-Referenzen, kommagetrennt.

int

Nur zusammen mit lat + lon.

int

Höchstens 200. Ersetzt keinen Filter.

curl -s "https://api.oeffigo.app/v1/predictions?line=U1&limit=50"

{
  "generatedAt": "2026-07-26T13:25:06.754Z",
  "count": 2,
  "predictions": [
    { "jid": "og1.…", "delayMin": 2, "confidence": "high" }
  ]
}

POST /v1/predictions/batch

Viele Fahrt-Referenzen auf einmal. Fahrt-Referenzen sind lang und gehören nicht in eine URL.

curl -s -X POST https://api.oeffigo.app/v1/predictions/batch \
  -H 'content-type: application/json' \
  -d '{"jids":["og1.…","og1.…"]}'

GET /v1/vehicles Pausiert

Fahrzeuge in einem begrenzten Kartenausschnitt. Einträge sind höchstens acht Minuten alt.

Pausiert. Die Fahrzeuganzeige ist derzeit aus. Der Endpunkt antwortet, liefert aber eine leere Liste mit "source": "none".

number

Kartenausschnitt – alle vier oder keiner.

string[]

Kommagetrennte Fahrt-Referenzen statt eines Ausschnitts.

number

Standard:"500"

1 bis 1.000.

curl -s "https://api.oeffigo.app/v1/vehicles?minLat=48.18&minLon=16.30&maxLat=48.24&maxLon=16.42"

string

Sagt, was ein leeres Ergebnis bedeutet: none heißt „Anzeige pausiert“, ondemand_live mit leerer Liste „gerade keine Fahrzeuge“, ondemand_capped „vorübergehend nicht verfügbar“.

GET /v1/wiener-linien/metro

Echtzeit der Wiener U-Bahn, gecacht. Nur für Stationen aus einer festen Liste – bewusst kein offener Proxy.

int

erforderlich

Stationskennung.

curl -s "https://api.oeffigo.app/v1/wiener-linien/metro?diva=60200657"

{
  "generatedAt": "2026-08-03T19:16:51.814Z",
  "status": "ok",
  "departures": [
    {
      "line": "1",
      "towards": "Stefan-Fadinger-Platz",
      "plannedAt": "2026-08-03T19:23:30.000Z",
      "realAt": "2026-08-03T19:26:50.000Z"
    }
  ]
}

Die Verspätung ist die Differenz aus realAt und plannedAt. Bei 503 source_standby ist die Quelle bewusst pausiert – versuch es später erneut. Datenquelle: Stadt Wien – data.wien.gv.at, CC BY 4.0.

GET /v1/announcements

Hinweise, die ÖffiGo ohne App-Update in den Apps ausspielt. Geschlossene und abgelaufene Meldungen sind nicht enthalten.

curl -s https://api.oeffigo.app/v1/announcements

Fahrt-Referenzen (og1.…) sind undurchsichtig. Verwende sie nur so, wie du sie bekommst – zerlegen oder selbst bauen funktioniert nicht.

​GET /v1/health

​GET /v1/status

​GET /v1/history

​GET /v1/punctuality

​Weitere Pünktlichkeits-Endpunkte

​GET /v1/disruptions/archive

​GET /v1/predictions Pausiert

​POST /v1/predictions/batch

​GET /v1/vehicles Pausiert

​GET /v1/wiener-linien/metro

​GET /v1/announcements

GET /v1/health

GET /v1/status

GET /v1/history

GET /v1/punctuality

Weitere Pünktlichkeits-Endpunkte

GET /v1/disruptions/archive

GET /v1/predictions Pausiert

POST /v1/predictions/batch

GET /v1/vehicles Pausiert

GET /v1/wiener-linien/metro

GET /v1/announcements