Skip to content
HALOWERK

Ortwerk

route shape

Finds the line by name among all routes calling at the given station, groups its trips into stop patterns (identical stop sequence) and returns the most frequent variants as a GeoJSON FeatureCollection (RFC 7946, WGS84). The free national feed has no shapes.txt, so each LineString connects the stops in order (stop-to-stop course, not the exact track or road geometry). Planned timetable from the gtfs.de Germany feed (free edition, CC BY 4.0, based on DELFI e.V. national timetable data; stop.

POST https://ort.halowerk.com/v1/route-shape

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
linestringYesLine name as shown on vehicles, e.g. "S11", "RE 5", "ICE 10", "106". Spaces and case are ignored.
stopobjectYesA stop served by the line (disambiguates lines with the same name): give exactly one of id (GTFS stop_id from this feed), name (e.g. "Köln Hbf") or lat+lon (nearest served stop within 1 km).
datestringNoOnly variants running on this date (YYYY-MM-DD). Default: whole feed period.
max_variantsintegerNoMaximum number of variants (most trips first).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "line",
    "stop"
  ],
  "properties": {
    "line": {
      "type": "string",
      "minLength": 1,
      "maxLength": 30,
      "description": "Line name as shown on vehicles, e.g. \"S11\", \"RE 5\", \"ICE 10\", \"106\". Spaces and case are ignored."
    },
    "stop": {
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "description": "A stop served by the line (disambiguates lines with the same name): give exactly one of id (GTFS stop_id from this feed), name (e.g. \"Köln Hbf\") or lat+lon (nearest served stop within 1 km).",
      "properties": {
        "id": {
          "type": "string",
          "minLength": 1,
          "maxLength": 40,
          "description": "GTFS stop_id from this feed (e.g. from stops-nearby)."
        },
        "name": {
          "type": "string",
          "minLength": 2,
          "maxLength": 100,
          "description": "Stop name; best match by name, exact matches first, then by number of departures."
        },
        "lat": {
          "type": "number",
          "minimum": 47,
          "maximum": 55.2,
          "description": "Latitude (WGS84)."
        },
        "lon": {
          "type": "number",
          "minimum": 5.5,
          "maximum": 15.5,
          "description": "Longitude (WGS84)."
        }
      }
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Only variants running on this date (YYYY-MM-DD). Default: whole feed period."
    },
    "max_variants": {
      "type": "integer",
      "minimum": 1,
      "maximum": 8,
      "default": 4,
      "description": "Maximum number of variants (most trips first)."
    }
  }
}

Open original schema

Published input example

{
  "line": "S11",
  "stop": {
    "name": "Köln Hbf"
  },
  "max_variants": 2
}

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 →