Search cached flights
Find cached itinerary and cabin quotes by route, date, transfer bank, program, price, seats, stops, and premium cabin percentage.
POST
https://apisv2.awardtoolapi.com/panorama/panorama_flight_searchExample request
Shell
curl --request POST \
'https://apisv2.awardtoolapi.com/panorama/panorama_flight_search' \
--header 'Content-Type: application/json' \
--data '{
"api_key": "YOUR_API_KEY",
"date_range": {
"from": "2027-02-15",
"to": "2027-02-21"
},
"origins": {
"airports": [
"SFO"
]
},
"arrivals": {
"countries": [
"JP"
]
},
"banks": [
"chase"
],
"alliances": [
"star-alliance"
],
"cabins": [
"Business"
],
"min_seats": 2,
"max_points": 80000,
"min_cabin_distance_percent": 80,
"max_duration_minutes": 750,
"max_stops": 0,
"limit": 50
}'Results use cached observations from the past 15 days. Different filters intersect. Multiple values in a list match any selected value. Minimums and maximums are inclusive and require a known value on the same quote.
Results are ordered by points, with ties broken by quote identity. Prices and availability can change between requests.
Request body
api_keystring · Required- An enterprise API key with Panorama access.
date_rangeobject · Required- Inclusive from and to travel dates in YYYY-MM-DD format. Search up to 365 dates, from yesterday through 365 days ahead.
originsobject · Optional- Combine airports or metro codes, countries, regions, continents and US states. For example, {"airports":["NYC"],"states":["CA"]} includes either location. Continents use AF, AN, AS, EU, NA, OC or SA. Omit for all origins.
arrivalsobject · Optional- Destination scope in the same format as origins. Examples include {"countries":["JP"]} and {"regions":["EUR"]}. Omit for all destinations.
datesstring[] · Optional- Specific departure dates in YYYY-MM-DD format, intersected with date_range.
days_of_weekinteger[] · Optional- Departure weekdays, from 0 (Sunday) to 6 (Saturday). Use [0,6] for weekends.
categoriesstring[] · Optional- Destination scenarios. Choose City, Beach, Family, Honeymoon, Foodie, Skiing, Off beaten path, Scuba Diving, Mountain, Golf or Fishing. Any selected category can match within arrivals.
programsstring[] · Optional- Booking program codes, such as AC or UA. Omit or send an empty list for all supported Panorama programs.
banksstring[] · Optional- Transfer from any selected bank. Use amex, bilt, capital one, chase, citi or wells fargo. Use none for programs without a listed bank. With programs, both filters must match. Prices are in airline miles.
alliancesstring[] · Optional- Booking-program membership. Choose star-alliance, oneworld, skyteam or independent. The operating carrier may belong to a different alliance.
transfer_promotionboolean · Optional- Require an active transfer bonus to the booking program. With banks, the offer must come from a selected bank. Award prices stay in airline miles.
transfer_promotion_optionsstring[] · Optional- Restrict bonuses to selected bank and program pairs, such as ["amex:AC","chase:UA"]. A nonempty list enables the promotion filter.
cabinsstring[] · Optional- Economy, Premium Economy, Business, or First. A flight with multiple qualifying cabins has one result per cabin.
airlinesstring[] · Optional- Two-character airline codes. At least one segment must match. Use unknown for itineraries without any reported carrier code.
exclude_airlinesstring[] · Optional- Exclude itineraries containing any listed segment carrier, even if another segment matches airlines. Use unknown to exclude itineraries without any reported carrier code.
flight_number_containsstring · Optional- Match part of a segment flight number. "UA 0087" matches UA87.
exclude_basic_economyboolean · Optional- Hide Economy quotes explicitly tagged as Basic Economy. An unreported tag keeps the quote in the results.
departure_time_rangeobject · Optional- Inclusive local departure times in HH:MM. For example, {"from":"22:00","to":"06:00"} spans midnight.
arrival_time_rangeobject · Optional- Inclusive local arrival times at the final destination. Uses the same format as departure_time_range.
min_duration_minutesinteger · Optional- Minimum total itinerary duration in minutes.
max_duration_minutesinteger · Optional- Maximum total itinerary duration in minutes.
min_connection_minutesinteger · Optional- Minimum total time spent on connections, in minutes.
max_connection_minutesinteger · Optional- Maximum total time spent on connections, in minutes.
min_stopsinteger · Optional- Minimum number of stops. Use 1 to require a connecting itinerary.
max_stopsinteger · Optional- Maximum number of stops. Use 0 for nonstop flights.
max_age_secondsinteger · Optional- Maximum age of the cached observation in seconds, up to 1,296,000 (15 days). Use 10800 for the past three hours.
observed_sinceinteger · Optional- Include observations at or after this UTC Unix timestamp in seconds. The 15-day cache window still applies.
min_seatsinteger · Optional- Require a reported seat count of at least this many in the quoted cabin, from 1 to 9. For a travel party, use the total number of seats needed.
max_seatsinteger · Optional- Maximum reported seat count for this cabin, from 1 to 9.
min_pointsinteger · Optional- Inclusive minimum airline miles per passenger in the quoted cabin.
max_pointsinteger · Optional- Inclusive maximum airline miles per passenger for this cabin.
consider_cardmember_pricingboolean · Optional- Use a lower, explicitly reported United or Delta cardmember price for the same cabin when available. Filtering, returned points, sorting and map ranges all use that price. Defaults to false.
min_taxes_usdnumber · Optional- Inclusive minimum reported taxes and fees per passenger in US dollars.
max_taxes_usdnumber · Optional- Inclusive maximum taxes and fees per passenger in US dollars. Zero is a valid cap.
max_total_cost_usdnumber · Optional- Maximum cash value per passenger of this cabin’s miles plus its reported fees. Miles default to 1 US cent each. A quote with unknown fees cannot qualify.
point_valuationobject · Optional- Program values for max_total_cost_usd, globally or inside cabin_filters. For example, {"version":1,"airline_cpp_x100":{"AC":150}} values an Aeroplan mile at 1.50 US cents. Per-program values range from 1 to 2000 hundredths of a cent.
min_cabin_distance_percentnumber · Optional- Minimum percentage of flown distance in the quoted cabin, from 0 to 100. For example, 80 on a First quote requires at least 80% of segment miles in First. A missing share is excluded.
max_cabin_distance_percentnumber · Optional- Maximum percentage of flown distance in this exact cabin, from 0 to 100.
min_premium_percentnumber · Optional- Minimum premium percentage reported by Panorama, from 0 to 100. Depending on the program, it uses airline-reported share or flight time and can combine Business and First.
max_premium_percentnumber · Optional- Maximum reported premium percentage, from 0 to 100. Combine with min_premium_percent for a range.
cabin_filtersobject · Optional- Set different numeric limits per cabin, such as {"Economy":{"max_points":40000},"Business":{"min_seats":2,"max_stops":0,"max_points":80000}}. Only listed cabins qualify. Each cabin must also meet the top-level filters. Use any min/max bounds for points, taxes, seats, stops, duration, connection time or cabin percentages, plus max_total_cost_usd.
limitinteger · Optional- Quotes per page, from 1 to 200. Defaults to 50.
cursorstring · Optional- To get the next page, copy next_cursor from the response and repeat the request with the same filters. Omit it on the first request.
Example response
JSON · response excerpt
{
"status": 200,
"data": [
{
"origin": "SFO",
"destination": "HND",
"date": "2027-02-15",
"program": "AC",
"flight_id": "AC_20270215_SFO_HND_BUSINESS_UA875",
"carriers": [
"UA"
],
"cabin": "Business",
"points": 75000,
"taxes_usd": 57.6,
"seats": 2,
"stops": 0,
"premium_percent": 100,
"cabin_distance_percent": 100,
"duration_minutes": 685,
"observed_at": 1794240000
}
],
"next_cursor": null
}Response fields
data[]- One cached cabin quote per itinerary and booking program. Empty when there are no matches.
date / origin / destination / flight_id / program / cabin- Together these identify the quote. Treat the flight ID as an opaque string.
points / taxes_usd / seats- Airline miles and cash fees for one passenger, and the reported seat count for that cabin. Unknown fees and seat counts are null.
carriers / stops / duration_minutes- Segment carrier codes, number of connections, and total travel time when available.
cabin_distance_percent- Percentage of flown segment miles in this exact cabin. A nonstop quote is 100%. A connecting quote without enough segment data returns null.
premium_percent / observed_at- Reported premium cabin share if available, and the time the itinerary was observed in Unix seconds.
next_cursor- Opaque continuation token. A null value means this was the last page.
Errors
400- Check field names, dates, filter values, and pagination parameters.
401 / 403- Supply a valid enterprise API key with access to this product.
405- Send a POST request with a JSON body.
429- The key owner reached a configured quota. Retry after the indicated reset.
503- The cached data service is temporarily unavailable. Retry the same request.