Search new departures for an issued train booking (SSE stream)

Search replacement solutions for the legs of an issued train booking and stream them as Server-Sent Events, using the same projection as POST /v1/trains/search. By default the booked stations are kept and only the date and time move (change_datetime); a journey that names departureStationId and arrivalStationId changes its stations too (change_itinerary, only on a booking whose GET .../operations lists it).

journeys name the legs to move (a group exactly as changeableLegIds lists it on GET .../operations) and the requested departure. Solutions departing before the requested time that day are not returned. The stream ends with event: done.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params

POST body for /v1/trains/bookings/{id}/change-search.

enum

change_datetime or change_itinerary. Optional: a journey that names stations is an itinerary change, one that does not is a date or time change. A value that contradicts the journeys is rejected.

journeys
array of objects
required
length ≥ 1

Journeys to move, one per trip, in trip order. A trip that is not listed keeps its booked departure.

Journeys*
Responses
200

SSE stream of replacement train solutions

401

Missing or invalid authentication

404

Booking not found

409

The operator does not allow changing the booking now

410

The change search expired; search again

422

The selection does not fit the booking or the operator's rules (INVALID_CHANGE_SELECTION; details[0].reason says why)

503

Booking or train provider unavailable

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here!