Browse API endpoints

Search route awards

Compare the lowest cached award prices by route and cabin across your selected origins, destinations, and travel dates.

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

Example 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.
View original API reference