Map flight availability
Get matching award counts and points ranges by destination using the same filters as cached flight search.
POST
https://apisv2.awardtoolapi.com/panorama/panorama_flight_mapExample request
Shell
curl --request POST \
'https://apisv2.awardtoolapi.com/panorama/panorama_flight_map' \
--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
}'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.
The map returns every matching destination in one response. Pass the same filters to cached flight search to inspect the individual quotes.
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.
Example response
JSON · response excerpt
{
"status": 200,
"total": 1,
"data": [
{
"destination": "HND",
"latitude": 35.5523,
"longitude": 139.78,
"count": 1,
"min_points": 75000,
"max_points": 75000,
"min_taxes_usd": 57.6,
"max_taxes_usd": 57.6
}
]
}Response fields
total- Total number of matching cabin quotes across all destinations. Equals the sum of the destination counts in this response.
data[].destination / latitude / longitude- Destination airport code and coordinates. A code without known coordinates still appears with null coordinates.
data[].count / min_points / max_points- Matching quotes and the lowest and highest mileage price at this destination. Each group uses exactly the flight search filters.
data[].min_taxes_usd / max_taxes_usd- Lowest and highest reported fees on matching quotes, in US dollars. Both are null when the destination has no reported fees.
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.