Die API von Verkehr Jetzt

Erste Schritte

Legen Sie unten einen Testschlüssel an und hängen Sie ihn an die Anfrage. Im Browser geöffnet, mit Ihrem Schlüssel am Ende, liefert das sofort Daten:

https://verkehrjetzt.de/api/v1/incidents?road=A7&type=baustelle&key=vj_…

Die Antwort ist JSON. Für eine Karte geben Sie &format=geojson an. Im Code gehört der Schlüssel besser in den Header:

curl -H "X-API-Key: vj_…" "https://verkehrjetzt.de/api/v1/incidents?land=hessen&type=sperrung"

Der Schlüssel

Seit dem 8. Oktober 2026 ist die API kostenpflichtig, und jede Anfrage braucht einen Schlüssel. Der Schlüssel, den Sie hier anlegen, ist ein Testschlüssel: Er gilt 5 Tage ab der ersten Anfrage, mit 120 Anfragen pro Stunde, damit Sie prüfen können, ob die API für Ihr Vorhaben taugt. Danach brauchen Sie einen der Tarife unten.

Wir fragen nach Name, E-Mail und Zweck aus drei Gründen: um Sie zu warnen, wenn eine amtliche Quelle ausfällt; um zu verstehen, was der API noch fehlt; und weil ein Schlüssel, den man sperren kann, alle vor einem außer Kontrolle geratenen Loop schützt.

Tarife

Bezahlt wird der Zugang zum Dienst: die Abfrage, die Limits und die Betreuung. Die Daten selbst gehören den Behörden, die sie veröffentlichen, und bleiben unter deren Lizenzen; ihre Angaben müssen erhalten bleiben.

So kommen Sie zu einem Tarif: Schreiben Sie an [email protected] mit dem Namen Ihres Projekts und der geplanten Nutzung. Wir antworten mit dem passenden Tarif und einer Rechnung und stellen Ihren Schlüssel um; er bleibt derselbe. Die Tarife Persönlich und Professionell laufen monatlich.

Endpunkt und Parameter

GET /api/v1/incidents liefert die Meldungen, die auch die Karte und die Seiten von Verkehr Jetzt zeigen, aus derselben Quelle und im selben Moment. Alle Parameter sind optional und lassen sich kombinieren; mehrere Werte trennen Sie mit Komma. Ein unbekannter Wert ergibt einen Fehler 400 mit den erlaubten Werten, nie stillschweigend eine leere Liste.

Beispiel

Eine echte Antwort der API, gekürzt:

GET https://verkehrjetzt.de/api/v1/incidents?road=A7&type=baustelle&status=active&limit=1

{
  "attribution": {
    "text": "Daten: Verkehr Jetzt",
    "url": "https://verkehrjetzt.de"
  },
  "meta": {
    "count": 1,
    "total": 193,
    "generatedAt": "2026-10-08T21:41:15.165Z",
    "licence": "Daten: Verkehr Jetzt (verkehrjetzt.de), über Roadscore, aus den amtlichen Quellen in sources. Quellenangabe ist in jedem Tarif Pflicht, für Verkehr Jetzt und für jede Originalquelle.",
    "sources": [
      {
        "id": "autobahn",
        "credit": "Die Autobahn GmbH des Bundes",
        "licence": "Datenlizenz Deutschland – Namensnennung – 2.0",
        "licenceUrl": "https://www.govdata.de/dl-de/by-2-0"
      }
    ]
  },
  "incidents": [
    {
      "id": "autobahn-2026-050464--vi-bs.2026-10-05_20-00-00-000.devi-zus.2026-10-05_20-00-00-000_014.de5",
      "type": "roadworks",
      "severity": "medium",
      "status": "active",
      "lat": 51.26847197492887,
      "lon": 9.517912947258962,
      "title": "A7 Kassel – Kassel Mitte",
      "description": "Die Baustelle ist zu folgenden Zeiträumen gültig:\n08.10.26 22:45 bis zum 09.10.26 05:00 Uhr.\nA7: Fulda -> Hannover, zwischen 0.1 km hinter Kassel und 1.0 km vor AK Kassel Mitte\nLänge: 0.1 km | Maximale Durchfahrtsbreite: 6 m\nA7 Einbau von Induktionsschleifen (Korrektur)",
      "source": "autobahn",
      "sourceUrl": "https://autobahn.de",
      "road": "A7",
      "roadClass": "A",
      "direction": "Fulda → Hannover",
      "location": "zwischen 0,1 km hinter Kassel und 1,0 km vor AK Kassel Mitte",
      "closure": "lanes",
      "hours": "22:45–05:00",
      "overnight": true,
      "windows": [
        {
          "from": "2026-10-08T20:45:00.000Z",
          "to": "2026-10-09T03:00:00.000Z"
        }
      ],
      "land": "hessen",
      "city": "kassel",
      "startedAt": "2026-10-08T20:45:00.000Z",
      "endsAt": "2026-10-09T03:00:00.000Z",
      "updatedAt": "2026-10-08T20:45:00.000Z"
    }
  ]
}

Felder der Antwort

• attribution: Text und Link, die Sie anzeigen müssen. Derselbe Inhalt kommt im Header X-Attribution.
• meta.count und meta.total: Meldungen in der Antwort und Treffer vor dem limit.
• meta.generatedAt: wann der Datenstand gezogen wurde.
• meta.sources: jede Quelle in der Antwort mit Quellenvermerk und Lizenz. Diese Angaben müssen Sie beibehalten.
• id, type, severity, status, lat, lon: Kennung, Art, Schwere, ob in Kraft oder geplant, Position.
• title und description: Kurztitel und der Wortlaut der Quelle, eine Zeile pro Zeile.
• road, roadClass, direction, location: Straße, Straßenklasse (A, B, L, S, K), Fahrtrichtung, Abschnitt.
• closure, overnight, windows, hours: was gesperrt ist und wann, so wie die Quelle die Zeitfenster veröffentlicht.
• delayMin: Verlust in Minuten bei einem Stau, wenn die Quelle ihn nennt.
• land, city: Bundesland und Stadt als Slug.
• startedAt, endsAt, updatedAt: Beginn, Ende, letzte Änderung (ISO 8601, UTC).
• source, sourceUrl: die amtliche Quelle und ihre Seite.

Felder ohne Wert fehlen, statt null zu sein.

Fehler

• 400: ein Parameter mit unbekanntem Wert; detail nennt die erlaubten.
• 401: kein Schlüssel. Bis zum 13. Oktober 2026 antwortet die API ohne Schlüssel noch, mit dem Hinweis im Header X-API-Notice und in meta.hinweis; ab dem 14. Oktober nicht mehr.
• 402: der Testzeitraum ist abgelaufen. Für einen Tarif schreiben Sie an [email protected].
• 403: der Schlüssel wurde gesperrt; detail nennt den Grund.
• 429: Limit erreicht; der Header retry-after nennt die Wartezeit in Sekunden.

Während des Tests nennt der Header X-API-Trial-Ends das Ende des Testzeitraums.

Limits

Test: 120 Anfragen pro Stunde. Persönlich: etwa 10.000 pro Tag. Professionell: etwa 100.000 pro Tag. Unternehmen: nach Vereinbarung. Gezählt wird pro Schlüssel, nicht pro IP, damit eine App mit vielen Nutzern nicht von einem einzelnen gebremst wird. Ohne Schlüssel (nur bis 13. Oktober) gelten 20 Anfragen pro Stunde. Die Header X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset zeigen den Stand.

Die Daten werden etwa einmal pro Minute neu gezogen: Häufiger als alle 30 Sekunden zu fragen bringt keine neue Meldung. CORS ist offen, Sie können die API also direkt aus dem Browser aufrufen.

Nutzungsbedingungen und Quellenangabe

Mit einem Testschlüssel oder einem bezahlten Tarif: Ein Produkt auf Grundlage dieser API ohne gültigen Schlüssel oder ohne Quellenangabe zu betreiben, ist keine erlaubte Nutzung.

Daten: <a href="https://verkehrjetzt.de">Verkehr Jetzt</a>

Die Daten stammen von der Autobahn GmbH des Bundes, von Ländern und Städten und erreichen uns über Roadscore. Die Quellenvermerke, wie die Anbieter sie verlangen:

• Die Autobahn GmbH des Bundes (Datenlizenz Deutschland – Namensnennung – 2.0)
• Baustelleninformationssystem Freistaat Sachsen (SPERRINFOSYS, LISt GmbH) (Datenlizenz Deutschland – Namensnennung – 2.0)
• © LBV.SH (Landesbetrieb Straßenbau und Verkehr Schleswig-Holstein), GDI-SH Baustelleninformationen (CC BY 4.0)
• MobiData BW: Verkehrsministerium Baden-Württemberg (Baustelleninformationen) und Landesmeldestelle BW (Verkehrsmeldungen) (Datenlizenz Deutschland – Namensnennung – 2.0)
• © Landesbetrieb Straßenwesen Brandenburg (LS) (Datenlizenz Deutschland – Namensnennung – 2.0)
• Digitale Plattform Stadtverkehr Berlin / Baustellen, Sperrungen und sonstige Störungen von besonderem verkehrlichem Interesse (Datenlizenz Deutschland – Namensnennung – 2.0)
• Freie und Hansestadt Hamburg, Behörde für Verkehr und Mobilitätswende (BVM), Baustellen Hamburg (Datenlizenz Deutschland – Namensnennung – 2.0)
• Landeshauptstadt München, Mobilitätsreferat, Baustellen – Temporäre Einschränkungen (Datenlizenz Deutschland – Namensnennung – 2.0)
• Stadt Köln, Baustellen (Datenlizenz Deutschland – Zero – 2.0)
• Stadt Frankfurt am Main – Straßenverkehrsamt, verkehrsrelevante Baustellen und Verkehrsmeldungen (Datenlizenz Deutschland – Namensnennung – 2.0)
• Landeshauptstadt Stuttgart, Stadtmessungsamt, Baustellen (CC BY 4.0)
• Stadt Leipzig, Verkehrs- und Tiefbauamt, Verkehrsraumeinschränkungen (Datenlizenz Deutschland – Namensnennung – 2.0)
• Stadt Karlsruhe, Digitale Mobilität (mobil.trk.de), Baustellen, mit Daten der beteiligten Gemeinden (CC BY 4.0)
• Stadt Aachen, Baustelleninformationssystem (Datenlizenz Deutschland – Namensnennung – 2.0)
• Stadt Dortmund, Tiefbauamt (Datenlizenz Deutschland – Zero – 2.0)
• Hanse- und Universitätsstadt Rostock (CC0 1.0)
• © Landeshauptstadt Kiel, Amt für Bauordnung, Vermessung und Geoinformation (CC BY 4.0)
• Stadt Ingolstadt (CC BY 4.0)
• Stadt Duisburg (CC BY 3.0 DE)
• Stadt Herne (Datenlizenz Deutschland – Zero – 2.0)
• Stadt Münster, Amt für Mobilität und Tiefbau (Datenlizenz Deutschland – Namensnennung – 2.0)
• Stadt Freiburg i. Br., Garten- und Tiefbauamt (Datenlizenz Deutschland – Namensnennung – 2.0)

Ehrlich zur Abdeckung

Die API liefert, was die amtlichen Quellen veröffentlicht haben, nicht was gerade auf der Straße passiert. Eine Straße ohne Meldung ist keine freie Straße, sondern eine, zu der niemand etwas veröffentlicht hat. Alle Autobahnen sind erfasst. Bundes-, Landes- und Kreisstraßen sind erfasst in Baden-Württemberg, Berlin, Brandenburg, Hamburg, Mecklenburg-Vorpommern, Sachsen, Schleswig-Holstein und Niedersachsen (nur Bundesstraßen), dazu die Baustellen von 17 Städten. Für Bayern, Bremen, Hessen, Nordrhein-Westfalen, Rheinland-Pfalz, Saarland, Sachsen-Anhalt und Thüringen gibt es außerhalb der Autobahnen noch keine offenen Daten.

Wenn Sie Warnungen darauf aufbauen, sagen Sie das Ihren Nutzern. Und nutzen Sie die API nicht für Notfallentscheidungen: Im Notfall 112.

Kontakt

Fragen, ein Tarif, ein verlorener Schlüssel oder eine Quelle, die fehlt: [email protected]. Die Seiten zu Sperrungen und Baustellen zeigen dieselben Daten, die die API liefert.