Search Trips
search_tripsFull Description
Searches for available travel routes between a departure and destination location. Accepts optional parameters including travel date, return date, number of passengers, vehicle class preference (train, bus, flight, ferry, van, taxi), currency, and sorting preference. Returns matching trip options with route details, schedules, pricing, and booking links to 12Go.
Parameters (3 required, 6 optional)
datestringDeparture date in YYYY-MM-DD format. Convert from any format the user provides (e.g., 'March 15', '15/03/2026'). This field is required. If the user does not specify a departure date, you MUST still provide `date` and set it to three calendar days from today in YYYY-MM-DD format.
fromstringOrigin location name (e.g., 'Bangkok', 'Phuket'). Correct any obvious spelling errors in the user's input before providing this value.
tostringDestination location name (e.g., 'Chiang Mai', 'Krabi'). Correct any obvious spelling errors in the user's input before providing this value.
date2stringReturn date in YYYY-MM-DD format. Include only for round-trip searches. Convert from any format the user provides (e.g., 'March 18', '18/03/2026'). Omit for one-way trips.
fxcodestringCurrency code for displayed prices (e.g., 'THB', 'USD'). Default: 'USD'.
langstringLanguage code for results. Default: 'en'.
seatsnumberNumber of passengers. Min: 1, Max: 20. Default: 2.
sortstringSort order for results. Allowed values: 'Recommended', 'Cheapest', 'Earliest Departure', 'Latest Departure', 'Fastest', 'Top Rated'. Default: 'Recommended'.
vstringVehicle type filter. Allowed values: 'all', 'avia', 'train', 'bus', 'charter', 'ferry', 'van'. Default: 'all'.
allaviatrainbuscharterferryvan