timetable

Reconstruct an itinerary from a protobuf-JSON itinerary identifier.

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

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

post/api/v6/refresh-itinerary

Request body

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.

Changes

Changed in 10 of the 52 revisions of this API.12517

Jul 30, 2026f4c11a2b04311See the full diff
- ○
  added the optional property legs/items/reservation to the response with the 200 status
  response-optional-property-added
Jul 16, 2026dbfe4b7f2bab61See the full diff
- ●
  added the new HGV enum value to the legs/items/from/modes/items/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new HGV enum value to the legs/items/intermediateStops/items/modes/items/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new HGV enum value to the legs/items/mode response property for the response status 200
  response-property-enum-value-added
- ●
  added the new HGV enum value to the legs/items/to/modes/items/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new HGV enum value to the legs/items/tripFrom/modes/items/ response property for the response status 200
  response-property-enum-value-added
- ●
  added the new HGV enum value to the legs/items/tripTo/modes/items/ response property for the response status 200
  response-property-enum-value-added
- ○
  added the new HGV enum value to the request property id/legs/items/mode
  request-property-enum-value-added
Jul 12, 202603f152d705b92See the full diff
- ○
  added the optional property legs/items/agencyFareUrl to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property legs/items/ticketUrls to the response with the 200 status
  response-optional-property-added
Jul 9, 2026ddd353807e6a2See the full diff
- ○
  added the optional property legs/items/steps/items/fromOsmNode to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property legs/items/steps/items/toOsmNode to the response with the 200 status
  response-optional-property-added
Jun 6, 2026457c392131be13See the full diff
- ●
  removed the request property detailedLegs
  request-property-removed
- ●
  removed the request property detailedTransfers
  request-property-removed
- ●
  removed the request property joinInterlinedLegs
  request-property-removed
- ●
  removed the request property language
  request-property-removed
- ●
  removed the request property numLegAlternatives
  request-property-removed
- ●
  removed the request property pedestrianProfile
  request-property-removed
- ●
  removed the request property requireBikeTransport
  request-property-removed
- ●
  removed the request property requireCarTransport
  request-property-removed
- ●
  removed the request property requireDisplayNameMatch
  request-property-removed
- ●
  removed the request property transitModes
  request-property-removed
- ●
  removed the request property useRoutedTransfers
  request-property-removed
- ●
  removed the request property withFares
  request-property-removed
- ●
  removed the request property withScheduledSkippedStops
  request-property-removed
May 25, 2026a2ab90068a355See the full diff
- ○
  added the optional property legs/items/from/stopCode to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property legs/items/intermediateStops/items/stopCode to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property legs/items/to/stopCode to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property legs/items/tripFrom/stopCode to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property legs/items/tripTo/stopCode to the response with the 200 status
  response-optional-property-added
May 22, 20261844a7e745fe5See the full diff
- ○
  added the new optional request property pedestrianProfile
  new-optional-request-property
- ○
  added the new optional request property requireBikeTransport
  new-optional-request-property
- ○
  added the new optional request property requireCarTransport
  new-optional-request-property
- ○
  added the new optional request property transitModes
  new-optional-request-property
- ○
  added the new optional request property useRoutedTransfers
  new-optional-request-property
May 21, 2026f808465a02ed6See the full diff
- ●
  added the new SPECIAL_EVENT enum value to the legs/items/alerts/items/cause response property for the response status 200
  response-property-enum-value-added
- ●
  added the new SPECIAL_EVENT enum value to the legs/items/from/alerts/items/cause response property for the response status 200
  response-property-enum-value-added
- ●
  added the new SPECIAL_EVENT enum value to the legs/items/intermediateStops/items/alerts/items/cause response property for the response status 200
  response-property-enum-value-added
- ●
  added the new SPECIAL_EVENT enum value to the legs/items/to/alerts/items/cause response property for the response status 200
  response-property-enum-value-added
- ●
  added the new SPECIAL_EVENT enum value to the legs/items/tripFrom/alerts/items/cause response property for the response status 200
  response-property-enum-value-added
- ●
  added the new SPECIAL_EVENT enum value to the legs/items/tripTo/alerts/items/cause response property for the response status 200
  response-property-enum-value-added
May 21, 20264f82b7d9f9561See the full diff
- ○
  endpoint added
  endpoint-added
Feb 21, 2026b7bf68a0d6f31See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 30 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history