Flights API

Flights Booking Flow

The Hotels Sales Platform using the following flow in order to search and book Flights.
Using the recommended booking flow will decrease potential errors and increase your productivity.

RequestExplanation
Search FlightsSearch for Flights based on different parameters and criterias.
Fare Info Get full updated information about a Flight (Fare rules, Cxl-Policy, pricing etc).
Get Payment Preferences Get the full payment preferences & option for a Flight.
Book FlightBook a Flight.
(Used to reserve a seat on a flight, essentially creating a booking or a reservation in the airline's system for the selected flight and passengers.)
Ticket Flight Ticket the Flight.
(Used to finalize the booking and issue the actual flight ticket. This is when the booking turns into a confirmed purchase.)

Post Booking Requests

RequestExplanation
Check StatusSubmits a Check-Status request to the supplier to retrieve the updates status.
Cancel FlightSubmits a Cancellation request to the supplier.

Flight booking flow - Requests

Search Flights

This function sends a request to all active suppliers using different parameters and search criteria, such as: destination city, currency, country of residency, travel dates, number of nights, rooms, and guests per room.
The response returns a list of flights and routes provided by the connected suppliers.

Search Flights API examples (Postman) - Click here.

Fare Info

This function retrieves the details of selected flight, the applicable fare rules, and the terms of the cancellation policy.

Fare Info API examples (Postman) - Click here.

Get Payment Preferences

This function retrieves the available payment options for a specific flight.

Flight payment preferences can be called either during the booking process, or addressing your request to the existing order, by providing the Segment ID.

👍

Note:

The response will now include a tag: BookIncludesTicketing (Boolean).

This tag will indicate whether the booking action is going to try and ticket the fare at the same time, meaning that you there's no need to use Ticket Flight Request after the segment is created.

If you are using our payment gateway services to collect payment from the consumer, you'll need to specify the Card element in the booking request, otherwise, a ticket might be created, but no payment will be collected from the customer.

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

Book Flight

Books a flight, used to hold a seat on a flight, creating a booking or reservation in the airline's system for the chosen flight and passengers.

👍

Note:

If you include card details or a service fee in the booking request, the system will ignore them.

As no card details are needed to complete the booking - unless <BookIncludesTicketing> is set to true in the PaymentPreferences response.

Book Flight API examples (Postman) - Click here.

Ticket Flight

Issue the flight ticket, used to finalize the booking and convert it into a confirmed purchase.

👍

Note:

If the Flight - Get Payment Preferences response returned: BookIncludesTicketing = True :

This tag will indicate whether the booking action is going to try and ticket the fare at the same time, meaning that you there's no need to use Ticket Flight Request after the segment is created.

Ticket Flight API examples (Postman) - Click here.

Post booking - Requests

Flights Check Status

This function submits a Check-Status request to the supplier to retrieve the updates status.

👍

Note:

Not all flight suppliers support the Check-Status operation.

Flights Check Status API examples (Postman) - Click here.

Cancel Flight

Submits a Flight Cancellation request to the supplier.

👍

Note:

In most cases, fare companies do not provide a cancellation policy upfront.

Our cancellation policy for Flights is based on the last ticketing date. Until this date, cancellations are generally refundable (unless otherwise specified in the cancellation policy we provide).

Once the Flight is ticketed, it is typically considered non-refundable. However, this does not always mean the ticket itself is non-refundable.

Amendment conditions are detailed in the fare rules and involve many parameters, some of which may prevent access to cancellation information until after ticketing has occurred.

Cancel Flight API examples (Postman) - Click here.