Panorama - Flight Detail

Description

Returns detailed award-flight options for a specific airport pair and travel date or date range. Results may include economy, premium economy, business, and first-class itineraries.

For example, you can retrieve cached flight details from SFO to JFK for 2024-11-24.

Request Fields

• origin — Origin airport’s IATA code, such as SFO.

• arrival — Destination airport’s IATA code, such as JFK.

• date — Start date of the search in YYYY-MM-DD format.

• date_end — Optional end date in YYYY-MM-DD format. When omitted, the API searches only the date specified in date.

Response Fields

The response contains flight availability for a specific route, travel date, and loyalty program.

Top-Level Fields

• date_program — Travel date and loyalty-program code in YYYY-MM-DD@PROGRAM format, such as 2024-02-15@AA.

• route — Airport pair in ORIGIN-DESTINATION format, such as SFO-JFK.

• data_ct — Total number of cached itineraries found for each cabin class.

• ns_data_ct — Number of nonstop itineraries found for each cabin class.

• data — Flight itineraries grouped by cabin class. Each cabin contains a list of available options.

• ls — Unix timestamp, in seconds, indicating when the response data was last observed.

• ls_s — Human-readable representation of ls. The applicable time zone should be documented.

• status — Response status code. A value of 200 indicates a successful request.

Cabin names such as Economy, Premium Economy, Business, and First may appear as dynamic keys in data, data_ct, and ns_data_ct. A cabin may be omitted when no qualifying availability is found.

data_ct

Contains the total number of cached itineraries found for each cabin class.

{
  "Economy": 40,
  "First": 39,
  "Business": 4
}

The count may be greater than the number of itineraries returned in data because the API returns only a limited number of the best options for each cabin.

ns_data_ct

Contains the number of nonstop itineraries found for each cabin class.

{
  "Economy": 5,
  "First": 4,
  "Business": 4
}

data

Contains flight options grouped by cabin class:

{
  "Economy": [],
  "Business": [],
  "First": []
}

Each itinerary may contain the following fields:

• date — Travel date in YYYY-MM-DD format.

• award_points — Points required for a one-way award ticket for one adult.

• surcharge — Taxes and carrier-imposed fees associated with the award ticket.

• currency — ISO currency code used for surcharge and payment.tax, such as USD.

• cabin_type — Cabin classes included in the itinerary. For mixed-cabin itineraries, cabin names are joined with an ampersand, such as Economy & First.

• airline_name — Airlines operating the itinerary. For itineraries involving multiple airlines, names are joined with an ampersand.

• airline_code — IATA codes of the operating airlines. Multiple codes are joined with an ampersand, such as AS & AA.

• program_code — Loyalty-program code through which the award can be booked.

• seats — Number of award seats known to be available at the displayed price. A value of -1 indicates that seat availability is unknown.

• last_seen — Unix timestamp, in seconds, indicating when the itinerary was last observed.

• percent_premium — Percentage of in-flight travel time spent in the requested premium cabin. For example, a first-class result containing an economy segment may have a value below 100.

• transfer_options — Other supported points programs or transferable currencies that may be used to book the award.

• payment — Summary of the points and taxes required for the award.

• fare — General itinerary information, including total travel time and individual flight segments.

transfer_options

Each transfer option may contain:

• program — Transferable-points program, such as bilt.

• points — Number of transferable points required.

{
  "program": "bilt",
  "points": 11500
}

payment

Contains a summary of the award cost:

• cabin — Cabin class used to price the award.

• miles — Number of miles or points required.

• tax — Taxes and fees charged in the currency specified by currency.

{
  "cabin": "Economy",
  "miles": 11500,
  "tax": 5.6
}

fare

Contains itinerary-level information:

• travel_minutes_total — Total journey duration in minutes, including connections and layovers.

• travel_time_display — Human-readable total journey duration, such as 5h 25m.

• day_count — Number of calendar-day changes between departure and arrival. A value of 0 indicates arrival on the same calendar date.

• products — Ordered list of flight segments that make up the itinerary.

products

Each item in products represents one flight segment:

• origin — Origin airport’s IATA code.

• destination — Destination airport’s IATA code.

• departure_time — Local scheduled departure date and time.

• arrival_time — Local scheduled arrival date and time.

• airline_code — IATA code of the airline operating the segment.

• flight_number — Flight number, including the airline code.

• aircraft — Aircraft type scheduled for the segment.

• cabin_type — Cabin class for the segment.

• travel_minutes — Scheduled flight duration in minutes.

• layover_time — Layover after this segment, in minutes. A value of 0 generally indicates the final segment or a nonstop itinerary.