book_flight
ChatGPTGenerate a booking link to complete a flight booking on happyfares.in. After searching for flights, use this tool to get a direct link where the user can enter passenger details and pay. The link pre-fills the flight selection so the user does not need to search again. You need the origin, destination, date, and airline from the search results.
check_route_availability
ChatGPTCheck which flight routes are available and what dates they operate on. Useful for checking if a specific route exists before searching.
create_price_alert
ChatGPTSet a price alert: notify the user when a flight fare drops to or below a target price. Use when user says 'alert me if it drops to ₹X' or 'notify when cheaper'. Requires a contact identifier (email or phone) so HappyFares can notify the user when the alert triggers.
get_addons
ChatGPTGet available add-on services for a flight: meals, extra baggage, and seat selection options. Requires the search_key and flight details from a previous search_flights result.
get_booking_status
ChatGPTCheck the status of a HappyFares flight booking. You can look up by booking ID or PNR number. Returns booking details including passenger names, flight info, ticket status, and payment status.
get_fare_rules
ChatGPTGet cancellation, date change, and refund policies for a specific flight fare. Requires the search_key and flight_key from a previous search_flights result, plus the fare_id of the fare you want rules for.
get_flexible_dates
ChatGPTFind cheaper flight dates near a target travel date (±7 days). Returns a heatmap of fares by date so users can identify the cheapest day to fly. Use when user is flexible on dates or asks 'when is the cheapest day to fly DEL to BOM in June?'.
get_price_prediction
ChatGPTPredict whether flight prices will rise, fall, or stay stable for a route on a given date. Uses HappyFares' AI price model trained on 39 lakh actual bookings. Returns recommendation (buy now vs wait), expected price change %, deal label (Best Buy / Fair Price / Overpriced), and reasoning. Use this when user asks 'should I book now?' or 'will prices drop?'.
get_ticket_details
ChatGPTGet detailed ticket information including e-ticket numbers, fare breakdown, and itinerary for a specific booking.
low_fare_calendar
ChatGPTGet a fare calendar showing the cheapest flight prices across multiple dates for a route. Great for finding the cheapest day to fly. Provide a travel date and it will show fares for dates around that period.
price_insight
ChatGPTGet price intelligence for a specific route and date. Tells you if the current price is cheap or expensive compared to historical data, whether prices are trending up or down, and whether you should BUY NOW, WAIT, or BOOK SOON. The more searches you do through HappyFares, the smarter this tool gets.
route_analytics
ChatGPTGet analytics on route popularity, trending searches, and demand patterns. Shows which routes are being searched most through HappyFares AI, and price trends for tracked routes. Internal tool for business intelligence.
search_flights
ChatGPTSearch for flights between two Indian cities. Returns all available flights with prices, airlines, timings, and stops — typically 10-20 options. Supports departure-time filtering (e.g., 'before 2pm', 'after 6am'). Use 3-letter IATA airport codes (DEL=Delhi, BOM=Mumbai, BLR=Bengaluru, MAA=Chennai, CCU=Kolkata, HYD=Hyderabad, GOI=Goa, COK=Kochi, JAI=Jaipur, AMD=Ahmedabad, LKO=Lucknow, PNQ=Pune, GAU=Guwahati). Dates can be in YYYY-MM-DD or DD-MM-YYYY format.
smart_search
ChatGPTAI-powered smart flight search that goes beyond basic search. Automatically checks: (1) Your exact date, (2) Nearby dates (+/- 2 days) for cheaper fares, (3) Alternate nearby airports that might have cheaper flights. Returns the best options with savings highlighted. Use this instead of search_flights when you want the best deal, not just a list.
