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.
  8. Confirm the booking with /api/v1/unified-booking/checkout/confirm.
  9. After booking success, continue with the Payment Request API.

Optional Content Endpoints​

Use these endpoints when you need marketing or discovery content:

  • /api/v1/tourmind/hotels/popular-destinations
  • /api/v1/tourmind/hotel-collections
  • /api/v1/tourmind/recommended-hotels