Search for trips
search-tripsFull Description
Search for available carpool, bus, or train trips
Parameters (3 required, 24 optional)
from_addressstringThe address or city of the departure location. MUST be explicitly stated by the user. If the user only mentions a destination (e.g. "I want to go to Lille"), do NOT guess or infer a departure city — ask the user where they are departing from instead of calling this tool.
localestringLocale for this search. Apply the FIRST matching rule and STOP: 1. Explicit request: the user explicitly asks for a specific locale or language → use it. 2. Geography: use the locale of the country of from_address/to_address (e.g. France → fr-FR, Belgium depends on city language → fr-BE or nl-BE, Brazil → pt-BR, Ukraine → uk-UA). 3. User language: use the locale matching the language the user is writing in (e.g. user writes in English → en-GB, user writes in French → fr-FR, user writes in Spanish → es-ES). 4. Default: en-GB. Example: "trips from Paris to Lyon" Paris and Lyon in France → fr-FR (rule 2: Geography), NOT en-GB.
en-GBcs-CZde-DEen-INes-ESes-MXfr-BEfr-FRhr-HRhu-HUit-ITnl-NLnl-BEpl-PLpt-PTpt-BRro-ROru-RUru-UAsk-SKsr-Latn-RStr-TRuk-UAbg-BGbs-BAel-GRen-PHes-ARes-BOes-CLes-COes-ECes-PEes-PYes-UYfr-MAid-IDmk-MKms-MYro-MDsq-ALth-THvi-VNto_addressstringThe address or city of the arrival location. MUST be explicitly stated by the user. If the user only mentions a departure (e.g. "I want to leave from Paris"), do NOT guess or infer an arrival city — ask the user where they want to go instead of calling this tool.
air_conditioningbooleanSelect only trips whose vehicle has air conditioning
dep_6am_to_noonbooleanSelect only trips departing between 06:00 and 12:00
dep_after_6pmbooleanSelect only trips departing after 18:00
dep_before_6ambooleanSelect only trips departing before 06:00
dep_noon_to_6pmbooleanSelect only trips departing between 12:01 and 18:00
departure_datestringThe departure date of the trip, in the format YYYY-MM-DD. This field is OPTIONAL — do NOT ask the user for a date if they have not provided one. Omit it entirely and proceed with the search when no date is mentioned.
direct_trips_onlybooleanSelect only direct trips, with no transfers or changes
disabled_accessbooleanSelect only trips whose vehicle is accessible to passengers with reduced mobility
e_ticketsbooleanSelect only trips that support e-tickets (paperless boarding)
from_cursorstringThe cursor for pagination, that can be obtained from a previous search-trips tool call
instant_bookingbooleanSelect only trips with instant booking (automatic approval — no need to wait for a confirmation)
max_two_backbooleanSelect only trips where the driver offers at most 2 seats in the back row
one_transferbooleanSelect only trips with exactly 1 transfer / connection
pets_allowedbooleanSelect only trips where pets are allowed on board
power_outletsbooleanSelect only trips whose vehicle has power outlets / charging points
reclining_seatsbooleanSelect only trips whose vehicle has reclining seats
requested_seatsnumberThe number of seats requested by the user for the trip.
restroomsbooleanSelect only trips whose vehicle has restrooms / toilets on board
smoking_allowedbooleanSelect only trips where smoking is allowed in the vehicle
sortstringSort order for the results. dep_time:asc = earliest departure first (default), price:asc = lowest price first, dep_dist:asc = closest pickup point to origin first, arr_dist:asc = closest drop-off point to destination first, duration:asc = shortest trip duration first
dep_time:ascprice:ascdep_dist:ascarr_dist:ascduration:ascsuper_driverbooleanSelect only carpool trips offered by Super Drivers — experienced, highly-rated drivers recognised by BlaBlaCar
transport_typestringThe type of transport for the trip search. This field is OPTIONAL — omit it entirely when the user does not specify a transport mode. MUST be set to "CARPOOLING" when the user explicitly mentions carpooling. MUST be set to "BUS" when the user explicitly mentions bus. MUST be set to "TRAIN" when the user explicitly mentions train. Never infer or guess a transport mode that was not explicitly stated by the user.
CARPOOLINGBUSTRAINverified_identitybooleanSelect only carpool trips offered by drivers whose identity has been officially verified
wifibooleanSelect only trips whose vehicle has Wi-Fi on board