Dynamic Packaging - API Documentation

Overview

The Dynamic Packaging service offers an advanced solution for concurrently searching flights and hotels, seamlessly integrating the capabilities of both Hotels and Flights APIs.

When a search request for Dynamic Packaging is received, the system provides the most favorable rates based on the specified criteria, taking into account the client’s specific implementation and agreements with their providers.

By default, the service suggests a package that includes the lowest-priced hotel and flight options available. Users can modify these default selections to customize the package according to the client’s specific requirements.

The Dynamic Packaging service offers the following capabilities:

  • 🤝 Search for hotels and flights in a single request.
  • ✅ Easily select and customize the desired hotel and flight options to create a package.
  • 📦 Create an Order that combines a Hotel Segment and a Flight Segment, forming a Dynamic Package.

👍

Notes:

  • The Dynamic Packaging service supports only Net suppliers.
  • Kindly verify all Prerequisites are met before using the service.

Dynamic Packaging API Flow

RequestExplanation
Search Hotels and FlightsThis request is used to search for a Hotels and Flights based on the search criteria.
Get Hotel PageThis request is used to retrieve the Hotels options (Optional - Filtering options).
Get Flights PageThis request is used to retrieve the Flights options (Optional - Filtering options).
Get Hotel Room PackagesThis request is used to get the available Rooms information for the specified Hotel.
Validate Flight RouteThis request is used to validate a specific Flight Route. (Fare Info)
Validate Hotel Room PackageThis request is used to validate a specific Hotel room. (Room information, Pricing and Cxl-Policy).
Get Payment InfoThis request is used to get the applicable payment options for a specific dynamic package which picked.
Book Hotel And FlightThis request is used to book a combination of a Hotel & Flight as a complete package.

1. Search Hotels and Flights

This request queries all active suppliers (Hotels and Flights) using various parameters and search criteria, such as destination city, currency, country of residence, travel dates, check-in/check-out dates and the number of passengers per the rooms and flights.

👍

Note:

The response provides a list of available hotel and flight route options from the connected suppliers, including airport names and codes, as well as filtering options for both flights and hotels.

These filters can later be applied in the Get Hotels / Flights page requests to refine the results, ensuring only hotels and flights that match the user's criteria are displayed.

Search Hotels and Flights API examples (Postman) - Click here.

2. Get Hotel Page

The Get Hotel Page request is used to fetch a page from the search results. Within the Get Hotel Page response, you will find information regarding the total number of pages, referred to as 'TotalPages'.

This enables you to request subsequent pages, starting with page 0 and progressing to the last page.

Additionally, the Get Hotel Page request allows you to fine-tune your hotel search by applying various filters, such as Minimum Price, Maximum Price, Star Rating, Basis, Class, Name, and more. (These filters are returned in the Search Response).

Get Hotel Page API examples (Postman) - Click here.

3. Get Flights Page

The Get Flights Page request is used to fetch a page from the search results. Within the Get Flights Page response, you will find information regarding the total number of pages, referred to as 'TotalPages'.

This enables you to request subsequent pages, starting with page 0 and progressing to the last page.

Additionally, the Get Flights Page request allows you to fine-tune your Flights search by applying various filters, such as Minimum Price, Maximum Price, Aircraft Type, Airlines, Alliance, Connections, Arrival Period and more. (These filters are returned in the Search Response).

Get Flights Page API examples (Postman) - Click here.

4. Get Hotel Room Packages

Get Hotel Room Packages request is used to get updated room information and options in a specific a hotel.
In order to send this request, all you need is the hotelID & sessionID which returned in the Get Hotel Page response.

Get Hotel Room Packages API examples (Postman) - Click here.

5. Validate Flight Route

The Validate Flight Route request confirms the availability of the flight for booking. The response includes details such as flight information, routes, cancellation policy, supplier remarks and more.

Validate Flight Route API examples (Postman) - Click here.

6. Validate Hotel Room Package

The Validate Hotel Room Package request confirms the availability of the hotel room for booking. The response includes details such as Hotel and Room information, pricing, cancellation policy, supplier remarks and more.

Validate Hotel Room Package API examples (Postman) - Click here.

7. Get Payment Info

Get Payment Info request is used to retrieve the booking payment possibilities for a selected package.
In order to send this request, all you need is the hotel Id , PackageID, Flight Route Id & sessionID that was returned in the previous responses.

Get Payment Info API examples (Postman) - Click here.

8. Book Hotel And Flight

The Book Hotel And Flight request allows you to submit a new booking request for the selected hotel and flight package, and returns the booking information such as : reference and booking status as a response.

Book Hotel And Flight API examples (Postman) - Click here.