An integral part of a flight integration is the quote API as this the way we live price and availability information from your server.
The quote API should be able to do the following:
- Return prices within a maximum of 30 seconds, and ideally within 10 as every extra second degrades the user experience.
- Provide the final price in the currency of the respective market. The final price shown on the website and the one returned by the API should be identical.
- Appropriately signal error messages to identify when a given flight is not available or that a route is not serviced by the 3rd party website.
- Provide the price in the same currency as is displayed on the provider website (this improves the price accuracy)
- Return Prices & Flights information in a single request (rather than multiple separate requests for each quote) – preferred
For flight search requests, we are able to provide your API with the following information:
- Origin (IATA format) for each flight segment
- Destination (IATA format) for each flight segment
- Flight date for each flight segment
- Cabin Class
- Number of passengers (adults, children and infants) : please also, provide us with the Age Group Brackets that are supported on your end (example : Adults - 12 above, Children 2-12, Infant - 0-2)
- City indicator - if your server accepts IATA city codes
- List of airports/cities and dates for multi-city searches (please note, we do not support non-airport locations)
The requests to your server can be HTTP GET or POST requests. Please include working examples and API documentation to explain the parameters in detail. For example for cabin classes, a mapping of the code used in API and the actual class service is required.
Along with working examples, we would also need the following items from you.
- For load testing purposes, what is the max request count per second(API Rate Limit)
- Age Group Brackets as mentioned above
- Booking Horizon (0-330 days) : How far advanced can the traveller book a ticket?
The response from your server should include the following information:
- Origin (IATA format)
- Destination (IATA format)
- Departure time
- Arrival time
- Marketing carrier
- Operating carrier (if different from marketing carrier)
- Flight number
- Cabin class
Per itinerary /quote:
- Base price
- All taxes and fees (including card fees, if present)
- Deeplink URL (if possible)
- It is recommend to include deeplink URL in each itinerary / quote, as you retain flexibility in case a change of URL is needed.
Additional fare information (where available, per segment or itinerary):
- Fare Basis Code (alpha-numeric characters)
- Booking Code/Fare Code/Booking Class/RBD/Reservation Booking Designator (one letter that represents the fare that the ticket is booked into)
- Fare Family Name (name of the fare family, for example Basic Economy, Flex, or Business Promo)