The Flight object

The Flight object

A flight is one way of making the trip you searched. legs follows the trip: one entry outbound, two for a round trip, one per legs item for multi-city. id is stable for the life of the search token and meaningless after it expires.

Attributes

idstringRequired

Opaque identifier of this itinerary. Pass it as resultId to /flights/details.

legsarray of objects

One entry per takeoff-to-landing journey. A one-way has one, a round trip two, a multi-city one per legs item you sent.

departurestring

Local departure time of the first segment.

arrivalstring

Local arrival time of the last segment.

durationinteger

Total elapsed time in minutes, including layovers.

stopsinteger

Number of stops. 0 is nonstop.

segmentsarray of objects

The individual flights that make up this leg.

airlinestring

IATA airline code, e.g. B6.

flightNumberstring

Airline flight number without the carrier prefix repeated, e.g. 723.

originstring

Departure airport for this segment.

destinationstring

Arrival airport for this segment.

departurestring

Local departure time, ISO-8601 without a zone, e.g. 2026-12-03T13:59:00.

arrivalstring

Local arrival time, same format.

durationinteger

Block time in minutes.

aircraftstring

Aircraft name when the carrier publishes one.

bookingOptionsarray of objects

Fares on this itinerary. Details expands each option with a booking URL, bags, and cabin amenities.

providerCodestring

IATA code of the selling airline or agency.

pricenumber

Displayed fare in the country’s native currency, per person unless noted.

currencystring

ISO 4217 code of that country’s native currency.

formattedPricestring

Same fare, already formatted for display.

totalPricenumber

Fare for the whole party.

formattedTotalPricestring

Whole-party fare, formatted.

isDirectboolean

True when this option is sold by the operating carrier.

isFreeCancellationboolean

True when the fare can be cancelled without a fee.

totalProvidersinteger

How many sellers offered this itinerary.

isBestboolean

True when this is the recommended option.

isCheapestboolean

True when this is the lowest fare on the page.