Browse API endpoints

Start a flight search

Submit a route and a departure date to search airline loyalty programs for live award seats. Save the task ID to retrieve the results.

POSThttps://apisv2.awardtoolapi.com/flight_trigger/search_real_time

Example request

Shell
curl --request POST \
  'https://apisv2.awardtoolapi.com/flight_trigger/search_real_time' \
  --header 'Content-Type: application/json' \
  --data '{
  "origin": "JFK",
  "destination": "LHR",
  "date": "2027-02-15",
  "programs": [
    "AA",
    "AC"
  ],
  "cabins": [
    "Business"
  ],
  "pax": "1",
  "api_key": "YOUR_API_KEY"
}'
Python example on GitHub

Submit one departure date per request. Save the returned task_id and use it to retrieve results as each program finishes.

If you split a search into program batches, supply the same task_id for batches that share a departure date.

Request body

originstring · Required
Three-letter IATA code of the departure airport.
destinationstring · Required
Three-letter IATA code of the arrival airport.
datestring · Required
Departure date in YYYY-MM-DD format.
programsstring[] · Required
Loyalty programs to search, identified by code. For example, AA searches American AAdvantage.
cabinsstring[] · Required
One or more of Economy, Premium Economy, Business, and First.
paxstring · Required
Number of travelers, supplied as a string.
task_idstring · Optional
Your identifier for this search. Omit it to have AwardTool generate one.
api_keystring · Required
Your AwardTool API key.

Example response

JSON · response excerpt
{
  "status": 200,
  "message": "request processed, exit early.",
  "task_id": "example-flight-search-01"
}

Response fields

task_id
Pass this value to the results endpoint to follow this search.
status
A value of 200 acknowledges the request.
message
Submission status. Flight availability arrives through the results endpoint.
View original API reference