Browse API endpoints

Map flight availability

Get matching award counts and points ranges by destination using the same filters as cached flight search.

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

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