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.