openapi: "3.0.0"
info:
  version: 1.0.1
  title: Autobahn App API
  contact:
    url: https://www.autobahn.de/datenschutz/
    email: kontakt@autobahn.de
    name: Die Autobahn GmbH des Bundes
  x-office: Bundesministerium für Digitales und Verkehr
  description: |
    Was passiert auf Deutschlands Bundesstraßen? API für aktuelle Verwaltungsdaten zu Baustellen, Staus und Ladestationen. Außerdem Zugang zu Verkehrsüberwachungskameras und vielen weiteren Datensätzen.
servers:
  - url: https://verkehr.autobahn.de/o/autobahn

paths:

  /:
    get:
      operationId: list-autobahnen
      summary: Liste verfügbarer Autobahnen
      description: Gibt eine Liste der verfügbaren Autobahnen zurück.
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Roads"

  /{roadId}/services/roadworks:
    get:
      operationId: list-roadworks
      summary: Liste aktueller Baustellen
      description: Gibt eine Liste der aktuellen Baustellen zu einer Autobahn zurück.
      parameters:
        - name: roadId
          in: path
          required: true
          schema:
            $ref: "#/components/schemas/RoadId"
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Roadworks"
        "204":
          description: Not found.
        "400":
          description: Internal server error.
        "404":
          description: Not found.

  /details/roadworks/{roadworkId}:
    get:
      operationId: get-roadwork
      summary: Details einer Baustelle
      description: Gibt Details zu einer konkreten Baustelle zurück.
      parameters:
        - name: roadworkId
          in: path
          required: true
          schema:
            type: string
            format: byte
            example: "Uk9BRFdPUktTX19tZG0ubndfXzAyLTgwMDAwIEQgNzEgMTkgMDkvS0xCV1JO"
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Roadwork"
        "204":
          description: Not found.
        "400":
          description: Internal server error.
        "404":
          description: Not found.

  /{roadId}/services/webcam:
    get:
      operationId: list-webcams
      summary: Liste verfügbarer Webcams
      description: Gibt eine Liste der Webcams zu einer Autobahn zurück.
      parameters:
        - name: roadId
          in: path
          required: true
          schema:
            $ref: "#/components/schemas/RoadId"
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Webcams"
        "204":
          description: Not found.
        "400":
          description: Internal server error.
        "404":
          description: Not found.

  # https://verkehr.autobahn.de/o/autobahn/details/webcam/%5BID%5D
  /details/webcam/{webcamId}:
    get:
      operationId: get-webcam
      summary: Details einer Webcam
      description: Gibt Details einer konkreten Webcam zurück.
      parameters:
        - name: webcamId
          in: path
          required: true
          schema:
            type: string
            format: byte
            example: "V0VCQ0FNX19OUldfU2lsYS1TaWduYWxiYXVfMTAxMDgxNDE3MjM4ODYzOTk5MTU="
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Webcam"
        "204":
          description: Not found.
        "400":
          description: Internal server error.
        "404":
          description: Not found.

  /{roadId}/services/parking_lorry:
    get:
      operationId: list-parking-lorries
      summary: Liste verfügbarer Rastplätze
      description: Gibt eine Liste der Rastplätze zu einer Autobahn zurück.
      parameters:
        - name: roadId
          in: path
          required: true
          schema:
            $ref: "#/components/schemas/RoadId"
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ParkingLorries"
        "204":
          description: Not found.
        "400":
          description: Internal server error.
        "404":
          description: Not found.

  /details/parking_lorry/{lorryId}:
    get:
      operationId: get-parking-lorry
      summary: Details eines Rastplatzes
      description: Gibt Details eines konkreten Rastplatzes zurück.
      parameters:
        - name: lorryId
          in: path
          required: true
          schema:
            type: string
            format: byte
            example: "UEFSS0lOR19fbWRtLmxvcnJ5LnBhcmtpbmdfX0RFLVNILTAwMTEwOA=="
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ParkingLorry"
        "204":
          description: Not found.
        "400":
          description: Internal server error.
        "404":
          description: Not found.

  /{roadId}/services/warning:
    get:
      operationId: list-warnings
      summary: Liste aktueller Verkehrsmeldungen
      description: Gibt eine Liste der Verkehrsmeldungen zu einer Autobahn zurück.
      parameters:
        - name: roadId
          in: path
          required: true
          schema:
            $ref: "#/components/schemas/RoadId"
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Warnings"
        "204":
          description: Not found.
        "400":
          description: Internal server error.
        "404":
          description: Not found.

  /details/warning/{warningId}:
    get:
      operationId: get-warning
      summary: Details zu einer Verkehrsmeldung
      description: Gibt Details zu einer konkreten Verkehrsmeldung zurück.
      parameters:
        - name: warningId
          in: path
          required: true
          schema:
            type: string
            format: byte
            example: "V0FSTklOR19fbWRtLnZpel9fTE1TLU5XL3JfTE1TLU5XLzMyNDE3OV9EICBOVyBMTVMtTlcuMA=="
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Warning"
        "204":
          description: Not found.
        "400":
          description: Internal server error.
        "404":
          description: Not found.

  /{roadId}/services/closure:
    get:
      operationId: list-closures
      summary: Liste aktueller Sperrungen
      description: Gibt eine Liste der Sperrungen zu einer Autobahn zurück.
      parameters:
        - name: roadId
          in: path
          required: true
          schema:
            $ref: "#/components/schemas/RoadId"
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Closures"
        "204":
          description: Not found.
        "400":
          description: Internal server error.
        "404":
          description: Not found.

  /details/closure/{closureId}:
    get:
      operationId: get-closure
      summary: Details zu einer Sperrung
      description: Gibt Details zu einer konkreten Sperrung zurück.
      parameters:
        - name: closureId
          in: path
          required: true
          schema:
            type: string
            format: byte
            example: "Q0xPU1VSRV9fbWRtLnZpel9fTE1TLU5XL3JfVElDLU5SV0JMSy8zOS9OUldCTEsvMTAgMzUgMjEgRCAwOTI0Mi0wMV9EICBOVyBMTVMtTlcuMA=="
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Closure"
        "204":
          description: Not found.
        "400":
          description: Internal server error.
        "404":
          description: Not found.

  /{roadId}/services/electric_charging_station:
    get:
      operationId: list-charging-stations
      summary: Liste aktueller Ladestationen
      description: Gibt eine Liste der Ladestationen zu einer Autobahn zurück.
      parameters:
        - name: roadId
          in: path
          required: true
          schema:
            $ref: "#/components/schemas/RoadId"
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ElectricChargingStations"
        "204":
          description: Not found.
        "400":
          description: Internal server error.
        "404":
          description: Not found.

  /details/electric_charging_station/{stationId}:
    get:
      operationId: get-charging-station
      summary: Details zu einer Ladestation
      description: Gibt Details zu einer konkreten Ladestation zurück.
      parameters:
        - name: stationId
          in: path
          required: true
          schema:
            type: string
            format: byte
            example: "RUxFQ1RSSUNfQ0hBUkdJTkdfU1RBVElPTl9fMTczMzM="
      responses:
        "200":
          description: Success
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ElectricChargingStation"
        "204":
          description: Not found.
        "400":
          description: Internal server error.
        "404":
          description: Not found.

components:
  schemas:

    Roads:
      type: object
      properties:
        roads:
          type: array
          items:
            $ref: '#/components/schemas/RoadId'

    RoadId:
      type: string
      pattern: '[A-Z][A-Za-z]*[1-9]([0-9]{1,3})?(\/[A-Z][A-Za-z]*[1-9]([0-9]{1,3})?)?'
      description: |
        Kann jede gültige Straßenbezeichnung sein (nicht auf Autobahnen beschränkt). Die Gültigkeit wird nicht überprüft: Abfragen mit nicht existierenden Straßenbezeichnungen liefern einen leeren Datensatz zurück. Die Schreibweise kann von der sonst üblichen Form abweichen (z.B. S1234 statt St1234 für Staatsstraßen).
      example: "A1"

    Extent:
      type: string
      pattern: '-?\d+(?:\.\d+)?,\s*-?\d+(?:\.\d+)?,\s*-?\d+(?:\.\d+)?,\s*-?\d+(?:\.\d+)?'
      description: Rechteck (in WGS84-Koordinaten), das den betroffenen Streckenabschnitt umschließt.
      example: "10.728384054665147,54.00605746113356,10.775848767524598,54.09436740278899"

    Point:
      type: string
      pattern: '-?\d+(?:\.\d+)?,\s*-?\d+(?:\.\d+)?'
      description: Beginn des betroffenen Streckenabschnitts (Längengrad und Breitengrad in WGS84). Identisch zu Coordinate, jedoch sind rundungsbedingte Abweichungen möglich.
      example: "10.729057,54.006057"

    Coordinate:
      type: object
      description: Beginn des betroffenen Streckenabschnitts (Koordinaten in WGS84). Identisch zu Point, jedoch sind rundungsbedingte Abweichungen möglich.
      example: {
        "lat": "54.006057",
        "long": "10.729057"
      }
      properties:
        lat:
          $ref: '#/components/schemas/LatLongValue'
        long:
          $ref: '#/components/schemas/LatLongValue'

    LatLongValue:
      type: string
      pattern: '-?\d+(?:\.\d+)?'

    Identifier:
      type: string
      format: byte

    MultilineText:
      type: array
      example: [
          "Beginn: 29.06.2021 09:00",
          "Ende: 28.11.2021 17:00",
          "",
          "Art der Maßnahme:Asphaltdeckenerneuerung",
          "Einschränkungen:Es steht nur 1 Fahrstreifen zur Verfügung.\n\nVollsperrung der AS Eutin Ostseite vom 17.07.2021 - 15.09.2021.\n\nVollsperrung der AS Scharbeutz Ostseite vom 16.09.2021 - 17.11.2021.",
          "Maximale Durchfahrsbreite: 3.25\n"
      ]
      items:
        type: string

    IconRef:
      type: string
      description: |
        Sinnbild, das die Art des Eintrags beschreibt. Größtenteils sind diese dem offiziellen Verkehrszeichenkatalog entnommen, teilweise allerdings mit abweichender Bedeutung und/oder nicht offiziellen Unternummern. Wo kein passendes Verkehrszeichen existiert, werden nicht-numerische Werte verwendet:
        <ul>
        <li>101: Gefahr</li>
        <li>123: Bauarbeiten</li>
        <li>250: Sperrung</li>
        <li>262-2: Max. 3,5t</li>
        <li>314-50: Park-/Rastplatz (Pkw/Lkw)</li>
        <li>314-50-2: Park-/Rastplatz (nur Pkw)</li>
        <li>448: Anschlussstelle gesperrt</li>
        <li>charging_plug_strong: Schnellladestation für E-Fahrzeuge</li>
        <li>warnkegel: Kurzzeitbaustelle</li>
        </ul>

    DisplayType:
      type: string
      enum:
        - ROADWORKS
        - WEBCAM
        - PARKING
        - WARNING
        - WEIGHT_LIMIT_35
        - CLOSURE
        - CLOSURE_ENTRY_EXIT
        - STRONG_ELECTRIC_CHARGING_STATION
        - SHORT_TERM_ROADWORKS
        - ELECTRIC_CHARGING_STATION

    LorryParkingFeatureIcon:
      type: object
      example: {
        "icon": "almofont almo-picnic_facility",
        "description": "Picknickmöglichkeiten",
        "style": ""
      }
      properties:
        icon:
          type: string
        description:
          type: string
        style:
          type: string

    RoadItem:
      type: object
      properties:
        extent:
          $ref: '#/components/schemas/Extent'
        identifier:
          $ref: '#/components/schemas/Identifier'
        routeRecommendation:
          type: array
          items:
            # ???
            type: object
        coordinate:
          $ref: '#/components/schemas/Coordinate'
        footer:
          $ref: '#/components/schemas/MultilineText'
        icon:
          $ref: '#/components/schemas/IconRef'
        isBlocked:
          type: string
        description:
          $ref: '#/components/schemas/MultilineText'
        title:
          type: string
        point:
          $ref: '#/components/schemas/Point'
        display_type:
          $ref: '#/components/schemas/DisplayType'
        lorryParkingFeatureIcons:
          type: array
          items:
            $ref: '#/components/schemas/LorryParkingFeatureIcon'
        future:
          type: boolean
        subtitle:
          type: string


    RoadEvent:
      allOf:
        - $ref: '#/components/schemas/RoadItem'
        - type: object
          properties:
            startTimestamp:
              type: string
              format: date-time

    Roadworks:
      type: object
      properties:
        roadworks:
          type: array
          items:
            $ref: '#/components/schemas/Roadwork'

    Roadwork:
      example: {
        "extent": "10.728384054665147,54.00605746113356,10.775848767524598,54.09436740278899",
        "identifier": "Uk9BRFdPUktTX19tZG0uc2hfXzYzMTU=",
        "routeRecommendation": [],
        "coordinate": {
          "lat": "54.006057",
          "long": "10.729057"
        },
        "footer": [],
        "icon": "123",
        "isBlocked": "false",
        "description": [
            "Beginn: 29.06.2021 09:00",
            "Ende: 28.11.2021 17:00",
            "",
            "Art der Maßnahme:Asphaltdeckenerneuerung",
            "Einschränkungen:Es steht nur 1 Fahrstreifen zur Verfügung.\n\nVollsperrung der AS Eutin Ostseite vom 17.07.2021 - 15.09.2021.\n\nVollsperrung der AS Scharbeutz Ostseite vom 16.09.2021 - 17.11.2021.",
            "Maximale Durchfahrsbreite: 3.25\n"
        ],
        "title": "A1 | AS Pansdorf (17) - AS Neustadt-Mitte (14)",
        "point": "10.729057,54.006057",
        "display_type": "ROADWORKS",
        "lorryParkingFeatureIcons": [],
        "future": false,
        "subtitle": "Lübeck Richtung Fehmarn",
        "startTimestamp": "2021-06-29T09:00:00.000+0200"
      }
      allOf:
        - $ref: '#/components/schemas/RoadEvent'

    Webcams:
      type: object
      properties:
        webcam:
          type: array
          items:
            $ref: '#/components/schemas/Webcam'

    Webcam:
      example:     {
        "extent": "6.861151,50.987423,6.861151,50.987423",
        "identifier": "V0VCQ0FNX19OUldfU2lsYS1TaWduYWxiYXVfMTAxMDgxMDk4ODE2NDgyOTQ4NTQ=",
        "routeRecommendation": [],
        "coordinate": {
          "lat": "50.987423",
          "long": "6.861151"
        },
        "footer": [
            "ID: WEBCAM__NRW_Sila-Signalbau_10108109881648294854"
        ],
        "icon": "webcam",
        "isBlocked": "false",
        "description": [],
        "title": "A1 | ID005 AK Köln-Nord",
        "operator": "NRW",
        "point": "6.861151,50.987423",
        "display_type": "WEBCAM",
        "lorryParkingFeatureIcons": [],
        "future": false,
        "imageurl": "https://www.verkehr.nrw/webcams/10108109881648294854.jpg",
        "subtitle": "Blickrichtung Dortmund",
        "linkurl": "https://www.blitzvideoserver.de/player_strassennrw.html?serverip=62.113.210.7&serverapp=strassennrw-rtplive&streamname=10108109881648294854"
      }

      allOf:
        - $ref: '#/components/schemas/RoadItem'
        - type: object
          properties:
            operator:
              type: string
            imageurl:
              type: string
              format: uri
            linkurl:
              type: string
              format: uri

    ParkingLorries:
      type: object
      properties:
        parking_lorry:
          type: array
          items:
            $ref: '#/components/schemas/ParkingLorry'

    ParkingLorry:
      example: {
        "extent": "10.979849815368652,54.362571716308594,10.979849815368652,54.362571716308594",
        "identifier": "UEFSS0lOR19fbWRtLmxvcnJ5LnBhcmtpbmdfX0RFLVNILTAwMTEwOA==",
        "routeRecommendation": [],
        "coordinate": {
          "lat": "54.362572",
          "long": "10.979850"
        },
        "footer": [],
        "icon": "314-50",
        "isBlocked": "false",
        "description": [
            "PKW Stellplätze: 21 ",
            "LKW Stellplätze: 20 "
        ],
        "title": "A 1 | Richtung Puttgarden",
        "point": "10.979850,54.362572",
        "display_type": "PARKING",
        "lorryParkingFeatureIcons": [
          {
            "icon": "almofont almo-picnic_facility",
            "description": "Picknickmöglichkeiten",
            "style": ""
          },
          {
            "icon": "almofont almo-restroom",
            "description": "Toilette vorhanden",
            "style": ""
          }
        ],
        "future": false,
        "subtitle": "(Ostseeblick S)"
      }

      allOf:
        - $ref: '#/components/schemas/RoadItem'

    Warnings:
      type: object
      properties:
        warning:
          type: array
          items:
            $ref: '#/components/schemas/Warning'

    Warning:
      example: {
        "extent": "8.61785,52.97344,8.69904,53.00507",
        "identifier": "V0FSTklOR19fbWRtLnZpel9fTE1TLU5JL3JfTE1TLU5JLzIxMjI2MF9EICBOSSBMTVMtTkkgIC4w",
        "routeRecommendation": [],
        "coordinate": {
          "lat": "53.005070",
          "long": "8.699040"
        },
        "footer": [],
        "icon": "101",
        "isBlocked": "false",
        "description": [
            "Beginn: 25.05.2021 00:00",
            "Ende: 30.11.2021 23:59",
            "",
            "A1 Bremen Richtung Osnabrück",
            "zwischen Dreieck Stuhr und Groß Ippener",
            "Fahrbahnverengung, geänderte Verkehrsführung, Staugefahr, bis voraussichtlich 30.11.2021",
            "Erweiterung PWC Kiekut."
        ],
        "title": "A1 | AS Delmenhorst-Ost (58b) - AS Groß Ippener (59)",
        "point": "8.699040,53.005070",
        "display_type": "WARNING",
        "lorryParkingFeatureIcons": [],
        "future": false,
        "subtitle": "Bremen Richtung Osnabrück",
        "startTimestamp": "2021-05-25T00:00:00.000+0200"
      }

      allOf:
        - $ref: '#/components/schemas/RoadEvent'

    Closures:
      type: object
      properties:
        closure:
          type: array
          items:
            $ref: '#/components/schemas/Closure'

    Closure:
      example: {
        "extent": "6.95325,51.02996,6.96491,51.03644",
        "identifier": "Q0xPU1VSRV9fbWRtLnZpel9fTE1TLU5XL3JfTE1TLU5XLzMxNTEyMV9EICBOVyBMTVMtTlcuMA==",
        "routeRecommendation": [],
        "coordinate": {
          "lat": "51.036440",
          "long": "6.964910"
        },
        "footer": [],
        "icon": "262-2",
        "isBlocked": "false",
        "description": [
            "Beginn: 20.06.2021 14:19",
            "Ende: 31.12.2025 23:59",
            "",
            "A1 Dortmund - Köln",
            "Leverkusener Brücke",
            "in beiden Richtungen gesperrt für LKW über 3,5 t, bis 31.12.2025"
        ],
        "title": "A1 | AK Leverkusen-West (99) - AS Köln-Niehl (100)",
        "point": "6.964910,51.036440",
        "display_type": "WEIGHT_LIMIT_35",
        "lorryParkingFeatureIcons": [],
        "future": false,
        "subtitle": "Dortmund Richtung Köln",
        "startTimestamp": "2021-06-20T14:19:26.000+0200"
      }

      allOf:
        - $ref: '#/components/schemas/RoadEvent'

    ElectricChargingStations:
      type: object
      properties:
        electric_charging_station:
          type: array
          items:
            $ref: '#/components/schemas/ElectricChargingStation'

    ElectricChargingStation:
      example: {
        "extent": "9.176298,53.090847,9.176298,53.090847",
        "identifier": "RUxFQ1RSSUNfQ0hBUkdJTkdfU1RBVElPTl9fMTI2OTk=",
        "routeRecommendation": [],
        "coordinate": {
          "lat": "53.090847",
          "long": "9.176298"
        },
        "footer": [],
        "icon": "charging_plug_strong",
        "isBlocked": "false",
        "description": [
            "A1 | Bremen | Raststätte Grundbergsee Nord",
            "27376 Sottrum",
            "",
            "Ladepunkt 1:",
            "AC Kupplung Typ 2",
            "43 kW",
            "",
            "Ladepunkt 2:",
            "DC Kupplung Combo, DC CHAdeMO",
            "50 kW"
        ],
        "title": "A1 | Bremen | Raststätte Grundbergsee Nord",
        "point": "9.176298,53.090847",
        "display_type": "STRONG_ELECTRIC_CHARGING_STATION",
        "lorryParkingFeatureIcons": [],
        "future": false,
        "subtitle": "Schnellladeeinrichtung"
      }

      allOf:
        - $ref: '#/components/schemas/RoadItem'
externalDocs:
  description: "Weiterführende Dokumentation"
  url: "https://github.com/bundesAPI/autobahn-api/blob/main/README.md"