Skip to main content

Connect Hotels Overview

Connect Hotels is Bundleport's unified hotel product that provides everything you need to build hotel booking experiences. It combines shopping operations (search and quote), booking management (book, cancel, retrieve), and content catalog (hotels, rooms, destinations) into a single, consistent API.

What is Connect Hotels?​

Connect Hotels is a complete hotel API solution that includes:

1. Shopping Operations​

Find and evaluate hotel options:

  • Search - Find available hotels matching your criteria
  • Quote - Revalidate pricing and availability before booking

2. Booking Management​

Create and manage reservations:

  • Book - Create a hotel reservation
  • Retrieve - Get booking details
  • List - Query bookings with filters
  • Cancel - Cancel a reservation

3. Content Catalog​

Access static hotel catalog data:

  • Hotels - Hotel information, descriptions, amenities
  • Rooms - Room types and descriptions
  • Destinations - Cities, regions, airports
  • Boards - Meal plans (RO, BB, HB, FB, AI)
  • Categories - Hotel categories

Architecture​

Connect Hotels
├── Shopping API (/hotels/v1/search, /hotels/v1/recheck)
│   └── Real-time availability and pricing
├── Booking API (/hotels/v1/bookings/*)
│   └── Reservation management
└── Content API (/content/hotels/v1/*)
    └── Static catalog data

All operations are available via:

  • REST API - Primary interface with OpenAPI documentation
  • GraphQL API - Hotel-X compatible schema
  • MCP Protocol - Tool-based interface for AI agents

The Booking Journey​

1. Search for Availability​

Start by searching for available hotels:

POST /hotels/v1/search

Input: Destination, dates, occupancy, filters
Output: List of available hotel options with pricing

2. Quote the Option​

Before booking, revalidate the price:

POST /hotels/v1/recheck

Input: optionRefId from search
Output: Updated pricing and availability confirmation

3. Book the Reservation​

Create the booking:

POST /hotels/v1/bookings

Input: optionRefId, traveller information, payment details
Output: Booking confirmation with references

4. Manage the Booking​

After booking, you can:

  • Retrieve booking details: GET /hotels/v1/bookings/{id}
  • List bookings: GET /hotels/v1/bookings?filters=...
  • Cancel booking: POST /hotels/v1/bookings/{id}/cancel

Multi-Supplier Aggregation​

Connect Hotels aggregates inventory from multiple suppliers:

  • Automatic Deduplication - Same hotel from different suppliers is consolidated
  • Smart Ranking - Business rules determine best options
  • Partial Failures - If one supplier fails, others continue
  • Performance - Parallel requests for faster responses

Content vs Transactional​

Content API​

  • Purpose: Static/semi-static catalog data
  • Update Frequency: Daily or on-demand sync
  • Use Case: Display hotel information, build search filters
  • Endpoints: /content/hotels/v1/*

Booking API​

  • Purpose: Real-time availability and booking operations
  • Update Frequency: Real-time per request
  • Use Case: Search, quote, book, cancel
  • Endpoints: /hotels/v1/*

Quick Start​

  1. Search for Hotels - Find available hotels
  2. Quote an Option - Validate pricing
  3. Create a Booking - Make a reservation
  4. Access Content - Browse hotel catalog

Next Steps​