Panorama provides access to cached award-flight data collected from millions of availability requests processed each day. Developers can retrieve up to one year of availability by region, country, or airport across 50,000+ popular routes.
\nThe dataset excludes flights that do not meet the 25% premium-cabin threshold.
\nPanorama provides three types of APIs:
\nRoute Data
\nSearch across multiple origins, destinations, and travel dates. The API returns the lowest award price for economy, premium economy, business, and first class across all supported loyalty programs. Results include both nonstop and connecting itineraries.
\nYearly Data
\nRetrieve up to one year of award availability for a specific airport pair. For each travel date and supported loyalty program, the API returns the lowest award price by cabin class for both nonstop and connecting itineraries.
\nFlight Details
\nRetrieve detailed flight options for a specific airport pair and travel date. Results include economy, premium economy, business, and first-class options.
\n For example, you can retrieve cached flight details for SFO–JFK on 2024-11-24.
Returns the program–route combinations that Panorama actively retrieves from the AwardTool website on a scheduled basis.
\nThis list is not exhaustive. If a route does not appear in the response, it does not necessarily mean Panorama does not support it. Routes searched by AwardTool users may also be retrieved and stored in the cache. If you are interested in an unlisted route, query the appropriate Panorama endpoint to check whether cached data is available.
\napi_key — Your API key. This is the only required field.update_time — Unix timestamp, in seconds, indicating when the route data was last updated.
route — Airport pair in ORIGIN-DESTINATION format, such as SFO-JFK.
program — Loyalty-program code associated with the route.
Returns the lowest award price across all supported loyalty programs for the specified origins, destinations, and travel dates. Results are provided for economy, premium economy, business, and first class, with separate values for all itineraries and nonstop itineraries.
\ndate_range — Date range to search. Specify the expected date format and whether the start and end dates are inclusive.
origins — List of region, country, or airport codes representing the permitted origins.
arrivals — List of region, country, or airport codes representing the permitted destinations.
Each item in the data array represents availability for one travel date, route, and loyalty program—for example, an American Airlines (AA) award from SFO to LHR on 2024-12-22.
date — Travel date.
program — Loyalty-program code associated with the result.
points — Lowest award price by cabin class across all eligible itineraries, including connecting flights. When multiple flights have the same lowest award price, the flight with the lowest taxes and fees is selected.
points_ns — Lowest award price by cabin class for nonstop itineraries only.
Both points and points_ns may contain:
y — Lowest economy-class award price.
w — Lowest premium-economy award price.
j — Lowest business-class award price.
f — Lowest first-class award price.
ls — Unix timestamp, in seconds, indicating when the flight data was last observed.
ss — Available award-seat counts for the lowest-priced flights. This field is available only for supported loyalty programs.
A cabin value may be null when no qualifying availability is found.
Returns up to one year of award-availability data for a specific airport pair across all supported loyalty programs. Results include the lowest award price for economy, premium economy, business, and first class, with separate values for all itineraries and nonstop itineraries.
\nid — Route identifier consisting of the origin and destination airport codes in ORIGIN-DESTINATION format, such as SFO-LHR.Each item in the data array represents availability for one travel date, route, and loyalty program—for example, an American Airlines (AA) award from SFO to LHR on 2024-12-22.
date — Travel date.
program — Loyalty-program code associated with the result.
points — Lowest award price by cabin class across all eligible itineraries, including connecting flights. When multiple flights have the same lowest award price, the flight with the lowest taxes and fees is selected.
points_ns — Lowest award price by cabin class for nonstop itineraries only.
Both points and points_ns may contain:
y — Lowest economy-class award price.
w — Lowest premium-economy award price.
j — Lowest business-class award price.
f — Lowest first-class award price.
ls — Unix timestamp, in seconds, indicating when the flight data was last observed.
ss — Available award-seat counts for the lowest-priced flights. This field is available only for supported loyalty programs.
A cabin value may be null when no qualifying availability is found.
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.
\nFor example, you can retrieve cached flight details from SFO to JFK for 2024-11-24.
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.
The response contains flight availability for a specific route, travel date, and loyalty program.
\ndate_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_ctContains the total number of cached itineraries found for each cabin class.
\n{\n \"Economy\": 40,\n \"First\": 39,\n \"Business\": 4\n}\n\nThe 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_ctContains the number of nonstop itineraries found for each cabin class.
\n{\n \"Economy\": 5,\n \"First\": 4,\n \"Business\": 4\n}\n\ndataContains flight options grouped by cabin class:
\n{\n \"Economy\": [],\n \"Business\": [],\n \"First\": []\n}\n\nEach itinerary may contain the following fields:
\ndate — 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_optionsEach transfer option may contain:
\nprogram — Transferable-points program, such as bilt.
points — Number of transferable points required.
{\n \"program\": \"bilt\",\n \"points\": 11500\n}\n\npaymentContains a summary of the award cost:
\ncabin — 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.
{\n \"cabin\": \"Economy\",\n \"miles\": 11500,\n \"tax\": 5.6\n}\n\nfareContains itinerary-level information:
\ntravel_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.
productsEach 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.
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.
\nFor 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.
\nFor example, you can retrieve American Airlines award availability from SFO to JFK for 2027-02-15.
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.
{\n \"date_program\": \"2024-02-15@AA\",\n \"route\": \"SFO-JFK\",\n \"data_ct\": {\n \"Economy\": 40,\n \"First\": 39,\n \"Business\": 4\n },\n \"ns_data_ct\": {\n \"Economy\": 5,\n \"First\": 4,\n \"Business\": 4\n },\n \"data\": {\n \"Economy\": [],\n \"First\": [],\n \"Business\": []\n },\n \"ls\": 1702041278,\n \"ls_s\": \"2023-12-08 05:14:38\",\n \"status\": 200\n}\n\nCabin classes are represented as dynamic keys. A cabin class may be omitted when no qualifying availability is found.
\ndate_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.
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_optionsEach transfer option contains:
\nprogram — Transferable-points program, such as bilt.
points — Number of transferable points required.
{\n \"program\": \"bilt\",\n \"points\": 11500\n}\n\npaymentcabin — Cabin class used to price the award.
miles — Number of miles or points required.
tax — Taxes and fees in the currency specified by currency.
{\n \"cabin\": \"Economy\",\n \"miles\": 11500,\n \"tax\": 5.6\n}\n\nfaretravel_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.
productsEach product represents one flight segment:
\norigin — 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.
The API Usage Metrics API provides detailed, per-day usage statistics associated with a specific API key. This endpoint enables clients to monitor and audit their API consumption across supported AwardTool services, including Panorama data endpoints and real-time search operations.
\nUsage data is aggregated by date and is intended for billing validation, quota monitoring, and operational transparency.
\nAll requests must include a valid api_key.
{\n \"api_key\": \"YOUR_API_KEY\"\n}\n\n{\n \"data\": [\n {\n \"date\": \"2023-12-11\",\n \"api_key\": \"683de76f-2e37-4253-8dbf-fd88b507bbc4\",\n \"panorama_flight_data\": 1,\n \"panorama_calendar_data\": 1,\n \"panorama_route_data\": 1,\n \"real_time_search\": 3\n },\n {\n \"date\": \"2023-12-12\",\n \"api_key\": \"YOUR_API_KEY\",\n \"panorama_calendar_data\": 1,\n \"api_usage\": 2\n }\n ],\n \"status\": 200\n}\n\nEach object in the data array represents usage metrics for a specific date.
Note: Fields may vary by date depending on which services were accessed on that day. Missing fields indicate zero usage for that category.
\nUsage data is aggregated per day and per API key.
\nCounts reflect successful API calls only.
\nThis endpoint is intended for monitoring and reporting purposes and does not modify usage quotas.
\nHistorical usage availability may be subject to retention limits.
\nValidate monthly usage against contractual limits
\nPower internal billing and invoicing workflows
\nMonitor consumption trends and optimize API usage
\nDisplay usage dashboards for enterprise clients
\n