Developer Guide

Developer Guide

🧭 Smart Distribution API – Developer Overview

This suite of APIs enables seamless hotel booking workflows—from destination discovery to reservation management. Below is a quick summary of each operation and its role in the booking lifecycle.


🔍 1. GetDestinations

Purpose: Fetches a list of supported cities/regions where hotel inventory is available. Use Case: Populate search filters, dropdowns, or auto-suggestions.


🏨 2. GetBestProperty

Purpose: Searches for the best available hotel properties in a destination based on dates and occupancy. Use Case: Display hotel options to users after selecting a destination.


🛏️ 3. GetAllProducts

Purpose: Retrieves room-level details including rate plans, pricing, amenities, and cancellation policies for a selected hotel. Use Case: Show available rooms and pricing options before booking.


4. PreCheckReservation

Purpose: Validates real-time availability and pricing before finalizing a booking. Use Case: Prevent booking failures due to rate changes or room unavailability. Output: Returns a preBookReservationId for use in final booking.


📦 5. CommitReservation

Purpose: Finalizes and commits the reservation to the supplier system. Use Case: Confirm booking and generate reservation reference. Includes: Guest details, payment info, and room selection.


6. CancelReservation

Purpose: Cancels an existing reservation using the original ReservationId and ConfirmationNumber. Use Case: Enable users to cancel bookings and receive cancellation confirmation.


⚠️ Error Handling

Standard HTTP error codes (400, 401, 403, 406, 415, 500) are used for validation, authentication, and system issues. Tip: Always validate responses and handle status flags gracefully.


🛠️ Integration Notes

  • All endpoints use HTTPS

  • Dates must be in ISO format (YYYY-MM-DD)

  • Replace [SD-Domain] with your actual API domain

  • Contact RateGain Integration Team for credentials and support

Last updated