Skip to content
HALOWERK

Ortwerk

journey plan

Own RAPTOR router (round-based public transit routing, Delling/Pajor/Werneck 2012) over the complete national German timetable, no external routing server. Earliest arrival for 0 up to 4 transfers, repeated with later start times to return non-dominated connections (later departure, earlier arrival or fewer transfers). Transfers: at least 2 min at the same stop, walking between stops up to 400 m straight line (×1.3 detour at 1.2 m/s) or between platforms of one station. Planned timetable.

POST https://ort.halowerk.com/v1/journey-plan

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
fromobjectYesOrigin: 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).
toobjectYesDestination: 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).
datestringNoService date YYYY-MM-DD (Europe/Berlin). Default: today. Must lie inside the feed validity (see data_basis).
timestringNoEarliest departure HH:MM (Europe/Berlin). Default: now.
max_transfersintegerNoMaximum number of transfers.
resultsintegerNoNumber of connections.
modesarrayNoOnly these modes (GTFS route_type groups).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "from",
    "to"
  ],
  "properties": {
    "from": {
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "description": "Origin: 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)."
        }
      }
    },
    "to": {
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "description": "Destination: 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": "Service date YYYY-MM-DD (Europe/Berlin). Default: today. Must lie inside the feed validity (see data_basis)."
    },
    "time": {
      "type": "string",
      "pattern": "^\\d{1,2}:\\d{2}$",
      "description": "Earliest departure HH:MM (Europe/Berlin). Default: now."
    },
    "max_transfers": {
      "type": "integer",
      "minimum": 0,
      "maximum": 4,
      "default": 3,
      "description": "Maximum number of transfers."
    },
    "results": {
      "type": "integer",
      "minimum": 1,
      "maximum": 3,
      "default": 3,
      "description": "Number of connections."
    },
    "modes": {
      "type": "array",
      "maxItems": 12,
      "uniqueItems": true,
      "items": {
        "enum": [
          "tram",
          "subway",
          "rail",
          "bus",
          "coach",
          "ferry",
          "cable_tram",
          "aerial_lift",
          "funicular",
          "trolleybus",
          "monorail",
          "other"
        ]
      },
      "description": "Only these modes (GTFS route_type groups)."
    }
  }
}

Open original schema

Published input example

{
  "from": {
    "name": "Köln Hbf"
  },
  "to": {
    "name": "Bonn Hbf"
  },
  "time": "08:00",
  "results": 1
}

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 →