Skip to main content

Hotel API Guideline

This guide outlines the complete flow for integrating with the Hotel Distribution API.

Concept of Product Composition​

Integration Flow​

  1. Fetch hotel static data from /api/v1/tourmind/hotels.
  2. Show hotel details with /api/v1/tourmind/hotels/{slug} when the user opens a hotel.
  3. Use /api/v1/tourmind/hotels/suggestions to help users search by hotel name or destination.
  4. Search available hotels with /api/v1/tourmind/hotels/search.
  5. Request live prices for selected hotel codes with /api/v1/tourmind/hotels/search/prices.
  6. Load rooms and rates from /api/v1/tourmind/hotels/{slug}/rooms.
  7. Send the selected rate to /api/v1/unified-booking/checkout to review the final booking details and price (encrypted with encryptBookingPayload + X-Payload-Signature & X-Recaptcha-Token — see Checkout Security & Bot Protection).
  8. Confirm the booking with /api/v1/unified-booking/checkout/confirm (also protected by payload encryption, X-Payload-Signature, and X-Recaptcha-Token).
  9. After booking success, continue with the Payment Request API.