Panorama - Flight Detail Range

Description

Returns cached award-flight details for a specific airport pair and travel date or date range. Results can be filtered by loyalty program and are grouped into economy, premium economy, business, and first class.

For each cabin class, the API returns all itinerary details. The response also includes the total number of cached itineraries and the number of nonstop itineraries found.

For example, you can retrieve American Airlines award availability from SFO to JFK for 2027-02-15.

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, only the date specified in date is searched.

• program — Optional loyalty-program code or list of codes to include, such as AA. When omitted, results from all available programs are returned.

Response Structure

{
  "date_program": "2024-02-15@AA",
  "route": "SFO-JFK",
  "data_ct": {
    "Economy": 40,
    "First": 39,
    "Business": 4
  },
  "ns_data_ct": {
    "Economy": 5,
    "First": 4,
    "Business": 4
  },
  "data": {
    "Economy": [],
    "First": [],
    "Business": []
  },
  "ls": 1702041278,
  "ls_s": "2023-12-08 05:14:38",
  "status": 200
}

Cabin classes are represented as dynamic keys. A cabin class may be omitted when no qualifying availability is found.

Top-Level Response Fields

• date_program — Travel date and loyalty-program code in YYYY-MM-DD@PROGRAM format.

• route — Airport pair in ORIGIN-DESTINATION format.

• 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 — Itineraries grouped by cabin class. Each cabin contains up to 10 of the lowest-priced options.

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

• ls_s — Human-readable representation of ls.

• status — Response status code. A value of 200 indicates success.

The values in data_ct may be greater than the number of records returned in data because only the top 10 lowest-priced itineraries are returned for each cabin.

Itinerary Fields

Each item within a cabin-class array in data represents one itinerary.

• 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 the surcharge, such as USD.

• cabin_type — Cabin classes included in the itinerary. Mixed-cabin itineraries use an ampersand, such as Economy & First.

• airline_name — Airlines operating the itinerary. Multiple airline 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 means 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. This is 0 for economy itineraries and may be below 100 for mixed-cabin premium itineraries.

• transfer_options — Transferable-points programs that may be used to obtain the required miles.

• payment — Summary of the points and taxes required.

• fare — Itinerary-level schedule and duration information.

transfer_options

Each transfer option contains:

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

• points — Number of transferable points required.

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

payment

• cabin — Cabin class used to price the award.

• miles — Number of miles or points required.

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

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

fare

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

• travel_time_display — Human-readable 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 date.

• products — Ordered list of flight segments in the itinerary.

products

Each product represents one flight segment:

• origin — Origin airport’s IATA code.

• destination — Destination airport’s IATA code.

• departure_time — Scheduled local departure date and time.

• arrival_time — Scheduled local arrival date and time.

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

• flight_number — Flight number, including the airline code.

• aircraft — Scheduled aircraft type.

• cabin_type — Cabin class for the segment.

• travel_minutes — Scheduled segment duration in minutes.

• layover_time — Layover after the segment, in minutes. A value of 0 generally indicates the final segment.