Skip to content
HALOWERK

Ortwerk

autobahn roadworks

Fetches live roadworks (long- and short-term) and closures per motorway from the public Autobahn App API of Die Autobahn GmbH des Bundes (no key; https://verkehr.autobahn.de/o/autobahn). The free-text periods are parsed into concrete intervals in German local time: single days, date spans, construction phases, weekly recurring windows ("Jeden Montag . zwischen dem . und dem .") with listed exception days, plus the end of the overall measure. Returns per item the intervals, whether it.

POST https://ort.halowerk.com/v1/autobahn-roadworks

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
roadsarrayNoMotorways of the route in driving order, e.g. ["A1", "A43", "A2"].
corridorobjectNoOptional coordinate corridor of the planned route; only items near it are returned.
fromstringNoStart of your trip window.
tostringNoEnd of your trip window.
atstringNoPoint in time for active_at; default now.
only_relevantbooleanNoDrop items that certainly do not overlap the trip window.
vehicle_width_mnumberNoVehicle width to flag width restrictions.
vehicle_weight_tnumberNoActual vehicle mass to flag posted weight limits (closures of type CLOSURE_LOAD_*).
vehicle_height_mnumberNoVehicle height to flag height limits stated in the text.
typesarrayNo
include_geometrybooleanNoInclude the LineString geometry of each item.
snapshotarrayNoOptional: evaluate previously fetched Autobahn API items instead of fetching live (reproducible checks).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "roads": {
      "type": "array",
      "minItems": 1,
      "maxItems": 15,
      "items": {
        "type": "string",
        "pattern": "^[Aa]\\s?0*[1-9][0-9]{0,2}[a-zA-Z]?$"
      },
      "description": "Motorways of the route in driving order, e.g. [\"A1\", \"A43\", \"A2\"]."
    },
    "corridor": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "coordinates"
      ],
      "properties": {
        "coordinates": {
          "type": "array",
          "minItems": 2,
          "maxItems": 5000,
          "items": {
            "type": "array",
            "minItems": 2,
            "maxItems": 2,
            "items": {
              "type": "number"
            }
          },
          "description": "Route polyline as [lon, lat] pairs (WGS84)."
        },
        "buffer_m": {
          "type": "number",
          "minimum": 10,
          "maximum": 50000,
          "default": 2000,
          "description": "Keep items within this distance of the polyline."
        }
      },
      "description": "Optional coordinate corridor of the planned route; only items near it are returned."
    },
    "from": {
      "type": "string",
      "format": "date-time",
      "description": "Start of your trip window."
    },
    "to": {
      "type": "string",
      "format": "date-time",
      "description": "End of your trip window."
    },
    "at": {
      "type": "string",
      "format": "date-time",
      "description": "Point in time for active_at; default now."
    },
    "only_relevant": {
      "type": "boolean",
      "default": false,
      "description": "Drop items that certainly do not overlap the trip window."
    },
    "vehicle_width_m": {
      "type": "number",
      "minimum": 1,
      "maximum": 5,
      "description": "Vehicle width to flag width restrictions."
    },
    "vehicle_weight_t": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 100,
      "description": "Actual vehicle mass to flag posted weight limits (closures of type CLOSURE_LOAD_*)."
    },
    "vehicle_height_m": {
      "type": "number",
      "minimum": 1,
      "maximum": 6,
      "description": "Vehicle height to flag height limits stated in the text."
    },
    "types": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "roadworks",
          "closure"
        ]
      },
      "minItems": 1,
      "maxItems": 2,
      "default": [
        "roadworks",
        "closure"
      ]
    },
    "include_geometry": {
      "type": "boolean",
      "default": false,
      "description": "Include the LineString geometry of each item."
    },
    "snapshot": {
      "type": "array",
      "maxItems": 15,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "road"
        ],
        "properties": {
          "road": {
            "type": "string",
            "maxLength": 6
          },
          "roadworks": {
            "type": "array",
            "maxItems": 3000,
            "items": {
              "type": "object"
            }
          },
          "closure": {
            "type": "array",
            "maxItems": 3000,
            "items": {
              "type": "object"
            }
          }
        }
      },
      "description": "Optional: evaluate previously fetched Autobahn API items instead of fetching live (reproducible checks)."
    }
  }
}

Open original schema

Published input example

{
  "roads": [
    "A1"
  ],
  "from": "2026-11-14T08:00:00+01:00",
  "to": "2026-11-14T18:00:00+01:00",
  "vehicle_width_m": 2.55,
  "only_relevant": true
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →