1. Search

Mishor 4 Documentation‎ > ‎5. API Methods‎ > ‎2. Flights‎ > ‎

Initiate Request:

<auth>

<username>example</username>

<password>example</password>

<agent>example</agent>

</auth>

<flights-search roundTrip="true">

<dates>

</dates>

<filter type=”cabinClasses”>economy business first premiumEconomy</filter>

</filters>

<pax-group customerCountryCode="UK">

<pax>

</children>

</pax>

</pax-group>

</currencies>

</flights-search>

</request>

Request Parameters:

Parameter	Type	Comments
flight-search @roundTrip	boolean	is the search made for 1 way or with return
dates/departure	YYYY-mm-dd	the date of departure flight
dates/departureReturn	YYYY-mm-dd	the date of the return flight
area @type	origin/destination	origin or destination
area @entityType	location/terminal	location/terminal/metropolitan code
area @entityId	string	either cityid or a 3 letter terminal code
filter/@type = isNonStop	boolean	1 means show only non-stop flights, 0 shows flights with stops
filter/@type = cabinClasses	string	one or more of the following classes: economy business first premiumEconomy
filter/@type = plusMinusDays	int	flexible dates by X days
pax-group @customerCountryCode	country code	2 letter ISO code for the customer country
pax	node	the pax node describing the people who should be on the flight
pax/adults @count	int	the number of adults
pax/children @count	int	the number of children
pax/children/age	int	the age of each child
currencies @default	currency	3 letter ISO code for the default currency
currencies/currency @code	currency	3 letter ISO code for the accepted currency

Notes

dates/departureReturn is mandatory only if the @roundTrip option is set to "true"
filter nodes are not mandatory and can be omitted if not used
customerCountryCode is mandatory, and the same code should be used for the entire session flow. i.e. when searching for a specific country code, you must use the same country code for booking.
children are optional. if you are not search for a room with children, do not include the children node.
currencies are returned according to the list in the request. properties that use a currency that does not appear on the list will be converted to the "default" currency. to remove restrictions and return all currencies, add an attribute to the currencies node: all="true"
the "metropolitan" code is a IATA code of the city (like "LON" for london, or "PAR" for paris)

Asynchronous Response:

<response success="1" session="dv.UpX7Bz0osA">

<search status="working">

<server>http://mishor.example.com/</server>

</search>

</response>

The Asynchronous response consists of the following elements:

Parameter	Type	Comments
response @success	boolean	was the request successful
response @session	string	the search id of the requested search
server	url	the url of the search server to use for polling and booking

Open Jaw

In order to run an "Open jaw" search, you will need to add the following node under the "flight-search" node in the request:

</return>

The "return" node details the 2nd origin and destination. if the flight goes from A->B->C->D, the "return" node holds the "C" and "D" parts.

Initiate Poll

With the search response session id, it is now possible to start polling the results. For a description of the flow, please revert to section 3: Search Flow

Poll Request

<request version="4.0">

<auth>

<username>example</username>

<password>example</password>

<agent>example</agent>

</auth>

<flights-poll session="dv.UpX7Bz0osA" last="0"/>

</request>

Parameter	Type	Comments
flights-poll @session	string	the session id of the requested search
flights-poll @last	int	the last @last attribute received from the previous poll

Poll Response

<response success="1" session="dv.UpX7Bz0osA">

<job status="done"/>

<results last="1" count="33">

<result token="dv.1210273892" providers="InnstantTravel" on-request="0">

<price minCommissionablePrice="790.26" currency="EUR" final="0" commissionable="1" billable="1"/>

<outbound>

<connection id="0">

<info travelTime="PT7H25M"/>

<segment>

<flightNumber>795</flightNumber>

<carrierCode>TK</carrierCode>

<class>Economy</class>

<departure terminal="TLV" date="2014-12-15" time="12:30:00"/>

<arrival terminal="IST" date="2014-12-15" time="14:50:00"/>

</segment>

<segment>

<flightNumber>453</flightNumber>

<carrierCode>TK</carrierCode>

<class>Economy</class>

<departure terminal="IST" date="2014-12-15" time="18:15:00"/>

<arrival terminal="DOK" date="2014-12-15" time="20:10:00"/>

</segment>

</connection>

<connection id="1">

<info travelTime="PT8H05M"/>

<segment>

<flightNumber>791</flightNumber>

<carrierCode>TK</carrierCode>

<class>Economy</class>

<departure terminal="TLV" date="2014-12-15" time="01:20:00"/>

<arrival terminal="IST" date="2014-12-15" time="03:30:00"/>

</segment>

<segment>

<flightNumber>451</flightNumber>

<carrierCode>TK</carrierCode>

<class>Economy</class>

<departure terminal="IST" date="2014-12-15" time="07:25:00"/>

<arrival terminal="DOK" date="2014-12-15" time="09:20:00"/>

</segment>

</connection>

</outbound>

<inbound>

<connection id="0">

<info travelTime="PT6H40M"/>

<segment>

<flightNumber>454</flightNumber>

<carrierCode>TK</carrierCode>

<class>Economy</class>

<departure terminal="DOK" date="2014-12-25" time="21:15:00"/>

<arrival terminal="IST" date="2014-12-25" time="23:20:00"/>

</segment>

<segment>

<flightNumber>792</flightNumber>

<carrierCode>TK</carrierCode>

<class>Economy</class>

<departure terminal="IST" date="2014-12-26" time="00:50:00"/>

<arrival terminal="TLV" date="2014-12-26" time="02:55:00"/>

</segment>

</connection>

</inbound>

</result>

...

</results>

</response>

Parameter	Type	Comments
response @success	boolean	was the request successfull
job @status	string	"working" or "done"
results @last	int	keep this number for the next poll (see request)
results @count	int	how many results were returned in this specific poll response
result @id	int	the identifier of the specific result
result @providers	string	comma separated string of providers available for this property
result @availableBoards	string	comma separated string of boards available for this property
result/price	node	availablity coming from innstant.travel
result/price @currency	currency	3 letter ISO currency code
result/price @minCommissionablePrice	double	the minimum commissionable price - appears only if such result is available
result/price @minNonCommissionablePrice	double	the minimum non-commissionable price - appears only if such result is available
result/price @minAllowedPrice	double	minimum price to be displayed for B2C environment (BAR rate)
result/price @on-request	boolean	can the result be confirmed immediately
outbound	node	the outbound flight information
outbound/connection	node	connection is an "option" for a flight plan between the departure and arrival terminals
outbound/connection @id	int	an identifier for the connected
outbound/connection/info @travelTime	date interval string	ISO 8601 time interval string to show the duration of the entire flight
outbound/connection/segment	node	a segment is one "leg" of a flight plan
outbound/connection/segment/ flightNumber	integer	the flight number
outbound/connection/segment/ carrierCode	carrier code	2 letter IATA carrier code
outbound/connection/segment/ class	tring	segment flight class
outbound/connection/segment/ departure @terminal	terminal code	3 letter ISO code of the departure terminal
outbound/connection/segment/ departure @date	date	departure date in the terminal local time zone
outbound/connection/segment/ departure @time	time	departure time in the terminal local time zone
outbound/connection/segment/ arrival @terminal	terminal code	3 letter ISO code of the arrival terminal
outbound/connection/segment/ arrival @date	date	arrival date in the terminal local time zone
outbound/connection/segment/ arrival @time	time	arrival time in the terminal local time zone

Notes

The first poll request should be sent at least 3 seconds after the search response. You also need to wait at least 3 seconds between poll requests.
If there are no results from your direct providers, the non-billable-price node will not be returned
it is not allowed to add commission on top of non-commissionable items
B2C platforms MUST make sure that they never show prices that are lower than the minAllowedPrice attribute value
Dates and Times are returned in the local terminal timezone
the @travelTime format is based on the ISO 8601 standard. for example, "P3DT4H15M" means 3 days, 4 hours and 15 mintues. "P" is the prefix, "T" means the time. In case the carrier does not support this feature, the travelTime will be returned as "P0DT0H0M";

Comments