Browse API endpoints

Search cached flights

Find cached itinerary and cabin quotes by route, date, transfer bank, program, price, seats, stops, and premium cabin percentage.

POSThttps://apisv2.awardtoolapi.com/panorama/panorama_flight_search

Example 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.