Travel Search Proposals
travel_search_proposalsFull Description
Search for available train travel options between an origin and a destination and display a travel proposals widget with live data.
Use this tool when the user asks to find train journeys, schedules, or travel options between two cities or stations. The widget displays the complete list of available travel options, including departure times, arrival times, and journey durations.
Results must be displayed only through the widget and must not be restated or interpreted in the assistant response.
Limitations: Round-trip searches are not supported. If a round trip is requested, perform two separate searches for each direction. Seat selection and additional services (including OUIGO services) are not handled by this tool and must be completed on the SNCF Connect website.
Parameters (2 required, 12 optional)
destinationstringThe arrival location (station or city). Example: For 'Trip from Paris to Nantes', extract 'Nantes'.
originstringThe departure location (station or city). Example: For 'Trip from Paris to Nantes', extract 'Paris'.
best_pricebooleanSet to true to sort results by price.
Falsedeparture_datestringISO 8601 date/time (e.g., 2025-12-17T06:00:00+01:00). Default to 06:00 AM if time is unspecified. 'Tomorrow' should be converted to the correct date.
destination_contentstringOptional filter for arrival location. Use strictly when the user requests a specific station within a city.
directbooleanSet to true to filter for direct journeys.
Falsediscount_cardstringDiscount card code (e.g., YOUNG_PASS for Carte Jeune, WEEKEND_PASS for Carte Adulte, etc.).
YOUNG_PASSTGV_MAXWEEKEND_PASSLIBERTE_PASS_FESENIOR_PASSTGV_MAX_SENIORfastestbooleanSet to true to sort results by duration. Only if explicitly requested.
Falsemax_departure_datestringISO 8601 date/time (e.g., 2025-12-17T16:00:00+01:00). Use ONLY if the user asks for best price or fastest on an interval. Example : Give me the best price tomorrow morning -> departure_date:2025-12-17T06:00:00+01:00 maxDepartureDateParameter:2025-12-17T12:00:00+01:00
origin_contentstringOptional filter for departure location. Use strictly when the user requests a specific station within a city (e.g., 'Paris Gare de Lyon' but not 'Paris Bercy').
show_full_trainbooleanSet to true to include full or unavailable trains.
FalsetransportersarrayList of transporters to filter by (e.g., ['TGV INOUI', 'OUIGO']). only if explicitly requested.
[]travel_classstringTravel class: '1' (First), '2' (Second), or 'OPTIMUM'.
12OPTIMUMwhole_journeybooleanSet to true to show results for the whole day. CRITICAL: SET TO TRUE ONLY IF USER ASKS EXPLICITLY FOR 'ALL DAYS' ON CURRENT REQUEST. Default false.
False