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/predictions

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

In Entwicklung. Die Endpunkte antworten, liefern aber keine Prognosen. 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

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

number

Kartenausschnitt – alle vier oder keiner.

string[]

Kommagetrennte Fahrt-Referenzen statt eines Ausschnitts.

number

default:"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: ondemand_live mit leerer Liste heißt „gerade keine Fahrzeuge“, ondemand_capped heißt „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

required

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/predictions

​POST /v1/predictions/batch

​GET /v1/vehicles

​GET /v1/wiener-linien/metro

​GET /v1/announcements

GET /v1/health

GET /v1/status

GET /v1/history

GET /v1/predictions

POST /v1/predictions/batch

GET /v1/vehicles

GET /v1/wiener-linien/metro

GET /v1/announcements