Skip to content
Tools / Travel Booking
Travel Booking icon

Travel Booking

Book flights & hotels — real bookings

Travel Booking books real flights and hotel stays — not just searches. Both return a secure checkout link so the traveller pays directly with their card. It handles the full booking lifecycle from search results to confirmation, cancellation, and status checks.

For flights, pair it with the flight-search tool to find offers, then use this tool to convert the best offer into a real booking with a payment link. For hotels, search by location and dates, pick a rate, and get a checkout URL in seconds. Both flows support cancellation with a preview of refund terms before you commit.

What you can do

  • book_flight — book a flight from a search offer and return a checkout URL for the passenger to pay
  • get_booking — check status, tickets, and available actions for an existing flight booking
  • list_bookings — list recent flight bookings with status and totals
  • cancel_booking — preview refund terms or confirm cancellation for a flight booking
  • pay_held_booking — complete payment on a flight booking that was held without payment
  • search_stays — search for available hotels by location and dates with room rates and cancellation timelines
  • book_stay — book a hotel room from search results and return a checkout URL for the guest
  • get_stay_booking — retrieve full details of an existing hotel stay booking
  • cancel_stay — preview cancellation policy or cancel a hotel stay booking
  • search_deals — find the cheapest flight fares for a route in a given month, each with a direct booking link to complete purchase on Aviasales

Who it's for

Travel agents, AI concierge assistants, and anyone building booking workflows for flights and hotels.

How to use it

  1. For flights: use search_deals to find cheap fares with booking links, or run flight-search and call book_flight to book via the platform with a checkout URL
  2. For hotels: call search_stays with a location and dates, then book_stay with the rate_id and guest details to get a checkout URL
  3. Share the checkout URL or booking link with the traveller — they complete payment directly
  4. Use get_booking or get_stay_booking to check status after payment, and cancel_booking or cancel_stay to see refund terms before cancelling

Getting started

Connect your flight booking account to enable platform flight bookings. Hotel search and deal search work out of the box.

Book Flight

Book a flight from search results. Creates a booking and returns a payment link for the customer to complete the purchase with their card. The flight is held until payment is received. If the airline requires immediate payment, charges the platform balance instead.

Returns: Booking confirmation with order ID, booking reference, airline, ticket details, total charged, and cancellation deadline
Get Booking Details

Check the status of an existing flight booking. Returns booking reference, airline, route, dates, passengers, payment status, available actions, and ticket numbers.

Returns: Full booking details including reference, airline, route, dates, passengers, payment status, tickets, and available actions
List Bookings

List recent flight bookings. Returns a summary of each booking with order ID, booking reference, airline, route, dates, status, and total amount.

Returns: List of recent bookings with order ID, booking reference, airline, route, dates, status, and total amount
Cancel Booking

Cancel a flight booking and get refund information. When confirm is false (default), returns a refund quote without cancelling. When confirm is true, executes the cancellation with the airline and processes the refund.

Returns: Refund quote (when confirm is false) or cancellation confirmation with refund details (when confirm is true)
Pay Held Booking

Pay for a booking that was held without payment. Fetches the current order total and submits payment. Only works for orders that have not yet been paid.

Returns: Payment confirmation with payment ID, amount paid, and currency
Search Hotel Stays

Search for available hotel stays by location and dates. Returns accommodations with room options, rates, pricing breakdown (total, tax, fee, due at accommodation), cancellation timelines, rate conditions, and check-in/out times. Use rate_id from results to book.

Returns: List of available accommodations with room rates, pricing breakdown, cancellation timelines, and key collection info
Book Hotel Stay

Book a hotel stay from search results. Returns a checkout_url for the guest to pay via card. The checkout page confirms the rate, collects payment, and creates the booking — showing all required pricing, cancellation policy, conditions, and key collection details.

Returns: checkout_url for the guest to pay and complete the booking at toolrouter.com/checkout/stay
Get Stay Booking

Retrieve full details of an existing hotel stay booking. Returns booking reference, status, accommodation info, check-in/out times, pricing breakdown, cancellation timeline, rate conditions, and key collection instructions.

Returns: Full stay booking details including reference, pricing, cancellation policy, and key collection instructions
Cancel Stay Booking

Cancel a hotel stay booking. When confirm is false (default), shows the cancellation policy and conditions without cancelling. When confirm is true, cancels the booking immediately.

Returns: Cancellation policy preview (confirm:false) or cancellation confirmation (confirm:true)
Search Flight Deals

Find the cheapest flight fares for a route in a given month. Returns results sorted by price, each with a direct booking link to Aviasales so the traveller can complete the purchase.

Returns: Cheapest fares for the route sorted by price, with departure date, stops, duration, and a direct Aviasales booking link
Loading reviews...

Loading activity...

v0.062026-04-27
  • Added search_deals: cheapest flight fares for a route with direct Aviasales booking links
v0.052026-04-03
  • Added hotel stay booking: search_stays, book_stay, get_stay_booking, cancel_stay
v0.042026-03-22
  • Added subtitle, expanded description, and agent instructions
v0.032026-03-20
  • Return checkout_url for held bookings — customers pay via card on the website
v0.022026-03-20
  • Hold bookings without payment when airline allows, fall back to instant payment
  • Require title and gender fields for Duffel API compatibility
v0.012026-03-20
  • Initial release with flight booking, order management, cancellations, and payment

Travel Booking Use Cases(6)

Browse all 6 Travel Bookingguides →
Open Book Complete Travel Packages

Book Complete Travel Packages

Book flights, hotels, and transfers as a coordinated package for seamless travel planning.

Travel Booking icon
Travel Booking
4 agent guides
Open Plan Multi-Destination Trips

Plan Multi-Destination Trips

Coordinate flights across multiple destinations for complex travel itineraries with optimal routing.

Travel Booking icon
Travel Booking
4 agent guides
Open Search Papers by Topic

Search Papers by Topic

Find relevant academic papers on any research topic across millions of scholarly publications.

Academic Research icon
Academic Research
4 agent guides
Open Geocode Addresses to Coordinates

Geocode Addresses to Coordinates

Convert street addresses into precise latitude and longitude coordinates for mapping and spatial analysis.

Address Geocoding icon
Address Geocoding
4 agent guides
See every Travel Bookinguse case (Claude, ChatGPT, Copilot, OpenClaw guides) →

Related Tools

Frequently Asked Questions

What do I need to book a flight?

Start with a flight offer ID, then pass the passenger details the airline needs, such as name, title, gender, birth date, email, and phone number. International trips may also need identity documents.

What happens if a booking is held instead of confirmed?

If the order is held, you get a checkout URL to complete payment later. You can also use `pay_held_booking` to finish payment on an existing held order.

Can I check booking status after I place it?

Yes. `get_booking` returns the booking reference, route, passenger details, payment status, ticket numbers, and available actions.

Can I see a refund quote before cancelling?

Yes. `cancel_booking` supports `confirm: false`, which gives you a refund quote without cancelling. Set `confirm: true` only when you want to complete the cancellation.