Welcome to Travelstart API Documentation

Introduction

The Travelstart Flight API allows for the querying, booking and payment of flights via the Travelstart booking platform.

Message structures

The contents of the request / response messages, for the most part, conform to a series of XML Schemas created by the Open Travel Alliance created for the purpose of standardising messaging protocols between travel-based institutions.

Priced Itineraries

A Priced Itinerary contains all information pertaining to a flight, with a maximum of 2 separate legs. It is composed of an Air Itinerary, and Air Itinerary Pricing Information.

Air Itineraries

Contains details regarding a flight, such as departure and arrival dates and times, flight numbers etc.

Air Itinerary Pricing Information

Each Air Itinerary contains a sub-element which breaks down the pricing structure for the itinerary.

The Air Itinerary Pricing Information section ("AirItineraryPricingInfo") contains details regarding the pricing for a flight, such as the flight base fare and total taxes.

Air Itinerary Pricing is divided into 2 sections: the Itinerary Total Fare, and the Per Traveler Class (PTC) Fare Breakdown. The PTC Fare Breakdown is a summary of the fares applicable for each passenger, showing the Base Fare of a flight, a breakdown of the applicable taxes charged, and a total (the amount due for the passenger). The Itinerary Total Fare is a summary of this information for all passengers.

Each tax element contains the tax code, the tax amount, and a boolean indicator indicating whether or not the passenger is exempt from this tax (TaxExemptInd).

Locations

Location Codes can be specified as either a IATA code or a city code. City codes will typically be used when you have more than one airport per city and require the search to look at multiple airports within a metropolitan area, for example Istanbul has two airports - Atatturk(IST) and Sabiha Gokcen(SAW), The IATA code IST can refer to either the city of Istanbul (i.e both airports) or Ataturk only . Using ‘IST’ as a city code will include results from both Atatürk and Sabiha Gokcen. Using ‘IST’ as an IATA code will yield only Atatürk airport.

Amounts

Amounts are presented in a set of 3 currency groups: a regular Amount, a Display Amount, and an Original Amount.

If an itinerary's price has been converted from its native currency (often the currency used by the airline), the regular Amount field will contain the converted amount. The Original Amount, the Currency, the Decimal Places, and the Exchange Rate used to convert from the original amount will be included in the type. As such, the Amount field's value will always equal the Display Amount or the Original Amount.

Fare Baggage Allowance

Contains details regarding the flight's baggage options, such as baggage amount, taxes, description etc. It also contains boolean flags which indicate how the baggage option is to be offered. Please see Baggage Options for further details