Skip to content
HALOWERK

Ortwerk

transfer risk

Finds the arriving trip (line, planned arrival) and the departing trip (line, planned departure) at the station in the national planned timetable, measures the straight-line distance between the two platform positions, estimates the walking time (×1.3 detour, 1.2 m/s) plus a generic minimum transfer of 2 minutes, and classifies the remaining margin: below 0 min infeasible, 0–2 min high, 2–5 min medium, over 5 min low; rail-to-rail transfers under 5 minutes buffer are raised one class because.

POST https://ort.halowerk.com/v1/transfer-risk

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
stationobjectYesTransfer station: 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).
arrivalobjectYesArriving vehicle.
departureobjectYesDeparting vehicle.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "station",
    "arrival",
    "departure"
  ],
  "properties": {
    "station": {
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "description": "Transfer station: 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)."
    },
    "arrival": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "line",
        "time"
      ],
      "description": "Arriving vehicle.",
      "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."
        },
        "time": {
          "type": "string",
          "pattern": "^\\d{1,2}:\\d{2}$",
          "description": "Planned arrival HH:MM (±2 min tolerance)."
        }
      }
    },
    "departure": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "line",
        "time"
      ],
      "description": "Departing vehicle.",
      "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."
        },
        "time": {
          "type": "string",
          "pattern": "^\\d{1,2}:\\d{2}$",
          "description": "Planned departure HH:MM (±2 min tolerance)."
        }
      }
    }
  }
}

Open original schema

Published input example

{
  "station": {
    "name": "Köln Hbf"
  },
  "arrival": {
    "line": "RB48",
    "time": "12:22"
  },
  "departure": {
    "line": "S12",
    "time": "12:30"
  }
}

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 →