Browse API endpoints

Get flights by date range

Look up cached flight details across multiple dates for an airport pair and filter the results by loyalty program.

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

Example request

Shell
curl --request POST \
  'https://apisv2.awardtoolapi.com/panorama/panorama_flight_data_range' \
  --header 'Content-Type: application/json' \
  --data '{
  "api_key": "YOUR_API_KEY",
  "origin": "SFO",
  "arrival": "JFK",
  "date": "2027-02-15",
  "date_end": "2027-02-17"
}'

Request body

api_keystring · Required
The AwardTool API key issued for your integration.
originstring · Required
Three-letter IATA code for the departure airport.
arrivalstring · Required
Three-letter IATA code for the arrival airport.
datestring or integer · Required
Travel date. Send YYYY-MM-DD as a string, or YYYYMMDD as a string or integer.
date_endstring or integer · Optional
Last travel date, inclusive, in the same formats as date. Omit for a single day. A request can cover up to 30 days.
programstring · Optional
One loyalty-program code. Omit to search the available programs for this airport pair.

Example response

JSON · response excerpt
{
  "Economy": [
    {
      "date": "2027-02-15",
      "program_code": "AA",
      "airline_code": "AA",
      "cabin_type": "Economy",
      "award_points": 15000,
      "surcharge": 5.6,
      "currency": "USD",
      "seats": 2,
      "payment": {
        "cabin": "Economy",
        "miles": 15000,
        "tax": 5.6
      },
      "fare": {
        "travel_minutes_total": 320,
        "products": [
          {
            "origin": "SFO",
            "destination": "JFK",
            "flight_number": "AA16",
            "cabin_type": "Economy"
          }
        ]
      }
    }
  ],
  "Economy Premium": [],
  "Business": [],
  "First": []
}

Response fields

Cabin arrays
Each top-level cabin contains the cached options for the requested dates and programs. An empty array means there are no matching options for that cabin.
date / program_code
Use each itinerary's travel date and loyalty-program code to group results within a cabin.
award_points / surcharge / currency
Award price for one adult traveling one way, plus the cash fees and their currency.
seats
Seats observed at this price. A value of -1 means the seat count is unknown.
program_code / airline_code
The booking loyalty program and the operating airline codes, respectively.
payment / transfer_options
Mileage and tax breakdown for the quoted cabin, plus eligible points-transfer options when available.
fare.products[]
Individual flight segments, including airports, flight number and cabin. Check each segment for mixed-cabin awards.

Errors

400
Supply valid dates in chronological order and keep the inclusive range within 30 days.
View original API reference