Book

🧾 Booking API

The Booking API marks the final step in the search-to-book flow. It confirms the hotel reservation by requiring:

  • A valid Trace-ID
  • Room details (including roomIds)
  • Guest details corresponding to each room

šŸ‘¤ Guest Details

You must provide at least the lead guest’s information for every room.

To determine the exact guest details required, refer to the guest validation rules available in:

  • Rooms and Rates API
  • Price Check API

These APIs provide flags such as:

  • panMandatory
  • passportMandatory

These indicate whether specific documents (like PAN or passport) are required for booking the selected rate.

Book: Response Keys

KeyDescription
statusStatus of the booking after the call. Confirmed means the booking is successful. Show this status to the customer.
bookingRefIdTravClan’s unique reference for the booking (also called the bookingCode). Save it, and use it for booking details, cancellation and any support query.
providerConfirmationNumberConfirmation number issued by the supplier for the booking. Show it to the customer.

Usage: After a successful Book call, save bookingRefId first, since it is the only key that identifies the booking in later calls. Then show providerConfirmationNumber and status in the booking confirmation.

šŸ“˜ API Reference: Booking API Documentation


Did this page help you?