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.
POST
https://apisv2.awardtoolapi.com/flight_trigger/search_real_timeExample 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"
}'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.