v51

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-012281206.0 KB
timetable

Reconstruct an itinerary from an itinerary ID.

Experimental (API might change without prior notice and without API version bump). Only supports walking at start/end or station-to-station itineraries.

All parameters mirror those of the plan endpoint - see the plan endpoint for their descriptions.

get/api/v6/refresh-itinerary

Query parameters

itineraryIdstring required
requireDisplayNameMatchboolean
joinInterlinedLegsboolean
detailedTransfersboolean
detailedLegsboolean
withFaresboolean
withScheduledSkippedStopsboolean
numLegAlternativesinteger
transitModesMode[]
preTransitModesMode[]

Optional. Default is WALK. Modes allowed for the first (access) mile when reconstructing leg alternatives. Should match the preTransitModes of the original plan request.

postTransitModesMode[]

Optional. Default is WALK. Modes allowed for the last (egress) mile when reconstructing leg alternatives. Should match the postTransitModes of the original plan request.

pedestrianProfile'FOOT' | 'WHEELCHAIR'

Different accessibility profiles for pedestrians.

useRoutedTransfersboolean
requireBikeTransportboolean
requireCarTransportboolean
noCompulsoryReservationboolean
languagestring[]
pedestrianSpeednumber

Average speed for pedestrian routing in meters per second

Average speed for pedestrian routing on the first/last mile.

cyclingSpeednumber

Average speed for bike routing in meters per second

Average speed for bike routing on the first/last mile.

elevationCosts'NONE' | 'LOW' | 'HIGH'

Different elevation cost profiles for street routing. Using a elevation cost profile will prefer routes with a smaller incline and smaller difference in elevation, even if the routed way is longer.

  • NONE: Ignore elevation data for routing. This is the default behavior
  • LOW: Add a low penalty for inclines. This will favor longer paths, if the elevation increase and incline are smaller.
  • HIGH: Add a high penalty for inclines. This will favor even longer paths, if the elevation increase and incline are smaller.

Elevation cost profile for first/last-mile street routing.

maxMatchingDistancenumber

Maximum matching distance in meters to the street network.

Is limited by server config variable max_max_matching_distance, larger values are capped to this limit.

maxPreTransitTimeinteger

Maximum time in seconds for the first (access) street leg.

maxPostTransitTimeinteger

Maximum time in seconds for the last (egress) street leg.

preTransitRentalFormFactorsRentalFormFactor[]

Allowed rental form factors for the first (access) leg.

postTransitRentalFormFactorsRentalFormFactor[]

Allowed rental form factors for the last (egress) leg.

preTransitRentalPropulsionTypesRentalPropulsionType[]

Allowed rental propulsion types for the first (access) leg.

postTransitRentalPropulsionTypesRentalPropulsionType[]

Allowed rental propulsion types for the last (egress) leg.

preTransitRentalProvidersstring[]

Allowed rental providers for the first (access) leg.

postTransitRentalProvidersstring[]

Allowed rental providers for the last (egress) leg.

preTransitRentalProviderGroupsstring[]

Allowed rental provider groups for the first (access) leg.

postTransitRentalProviderGroupsstring[]

Allowed rental provider groups for the last (egress) leg.

ignorePreTransitRentalReturnConstraintsboolean

Ignore rental return constraints on the first (access) leg.

ignorePostTransitRentalReturnConstraintsboolean

Ignore rental return constraints on the last (egress) leg.

Response

reconstructed itinerary

durationinteger required

journey duration in seconds

startTimestring date-time required

journey departure time

endTimestring date-time required

journey arrival time

transfersinteger required

The number of transfers this trip has.

idstring required

Experimental (format might change). Opaque itinerary identifier. Pass it as itineraryId to refresh-itinerary endpoint for reconstruction using the new schedule/realtime data.