Search route awards
Compare the lowest cached award prices by route and cabin across your selected origins, destinations, and travel dates.
POST
https://apisv2.awardtoolapi.com/panorama/panorama_route_dataExample request
Shell
curl --request POST \
'https://apisv2.awardtoolapi.com/panorama/panorama_route_data' \
--header 'Content-Type: application/json' \
--data '{
"api_key": "YOUR_API_KEY",
"date_range": {
"from": "2027-02-15",
"to": "2027-02-17"
},
"origins": {
"airports": [
"SFO"
],
"countries": [],
"regions": []
},
"arrivals": {
"airports": [
"JFK"
],
"countries": [],
"regions": []
}
}'Request body
api_keystring · Required- The AwardTool API key issued for your integration.
date_rangeobject · Required- Set from and to to the first and last travel dates in YYYY-MM-DD format. Both dates are included.
originsobject · Required- Departure filters. Supply arrays named airports, countries and regions, using empty arrays for unused filters.
arrivalsobject · Required- Destination filters, using the same airports, countries and regions arrays as origins.
Example response
JSON · response excerpt
{
"status": 200,
"data": [
{
"date": "2027-02-15",
"route": "SFO-JFK",
"program": "AA",
"points": {
"y": 12500,
"j": 42500,
"ls": 1794240000,
"ss": {
"y": 2,
"j": 1
}
},
"points_ns": {
"y": 15000,
"j": 42500,
"ls": 1794240000
}
}
]
}Response fields
data[]- One row per travel date, airport pair and loyalty program.
date / route / program- The travel date, directional airport pair and booking program for this row.
points- Lowest award price by cabin across connecting and nonstop itineraries.
points_ns- Lowest award price by cabin among nonstop itineraries.
y / w / j / f- Economy, premium economy, business and first-class prices in points. A missing or null price means no qualifying award was found.
ls / ss- Unix observation time in seconds and, when available, seat counts by cabin for the lowest-priced awards.
Errors
400- Check that both dates are valid and that the end date is on or after the start date.