Get flights by date range
Look up cached flight details across multiple dates for an airport pair and filter the results by loyalty program.
POST
https://apisv2.awardtoolapi.com/panorama/panorama_flight_data_rangeExample 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.