{"info":{"_postman_id":"b85e2fd1-6fb4-4546-bd91-36f2d4e261c6","name":"Real-time Search Engine - AwardTool","description":"

The API delivers enterprise-level, real-time access to award ticket availability across a comprehensive set of global airline loyalty programs. It is designed to support high-volume, programmatic searches and enables clients to query award inventory using structured parameters such as travel dates, origin and destination airports, preferred airlines, cabin classes, and routing preferences.

The platform aggregates and continuously normalizes data from multiple airline programs into a unified and consistent response schema. This abstraction layer eliminates program-specific inconsistencies and provides a reliable interface for downstream consumption. API responses include detailed flight itineraries, award seat availability by cabin, mileage and points requirements, applicable surcharges where available, and other relevant redemption attributes.

Built for scalability and reliability, the API supports seamless integration into enterprise applications, analytics pipelines, and consumer-facing products. It enables partners to power award search, monitoring, and optimization workflows while maintaining consistent high data quality and predictable performance.

Real-Time Search API Sample Code (Recommended)

https://gist.github.com/awardtool/8947354e6a2f24469cf4a07ddb82bd9f

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"31698313","collectionId":"b85e2fd1-6fb4-4546-bd91-36f2d4e261c6","publishedId":"2sBXVZmtKP","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-12-22T18:51:01.000Z"},"item":[{"name":"Real-time Search API - Crawler Trigger","id":"5cdc7f8c-c595-4bd4-86a7-d9f68f29de7d","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{}},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"origin\": \"JFK\",\n \"destination\": \"LHR\",\n \"programs\": [\"UA\"],\n \"cabins\": [\"Economy\", \"Premium Economy\", \"Business\", \"First\"],\n \"date\": \"2025-12-25\",\n \"pax\": \"1\",\n \"task_id\": \"db8032021-ffd0-4301c-80f6-731de2d\", //Create uuid for each request\n \"api_key\": \"YOUR_API_KEY\"\n}","options":{"raw":{"language":"json"}}},"url":"https://apisv2.awardtoolapi.com/flight_trigger/search_real_time","description":"

Overview

Trigger a Flight Search

Submits a flight search to the processing queue. Award availability is retrieved asynchronously and can be associated with related requests through a client-defined task_id.

Query Constraints

Each request must search exactly one travel date. Date ranges are not supported.
\n
A request may include multiple loyalty programs, but a maximum of five programs per request is recommended.
\n
To search more than five programs for the same date, divide them across multiple requests using the same task_id.
\n
All requests sharing a task_id must use the same travel date.
\n
Usage is calculated per program-date search. For example, a request containing five programs counts as five searches.
\n

Request Fields

`pax`

Type: Integer
\n
Required: Yes
\n
Description: Number of passengers included in the search.
\n

`programs`

Type: Array of strings
\n
Required: Yes
\n
Description: Loyalty-program codes to search.
\n
Recommendation: Include no more than five programs per request.
\n

`cabins`

Type: Array of strings
\n
Required: Yes
\n
Description: Cabin classes to include.
\n
Supported values:
\n
- Economy
  \n
- Premium Economy
  \n
- Business
  \n
- First
  \n
\n

`origin`

Type: String
\n
Required: Yes
\n
Description: Origin airport’s three-letter IATA code, such as SFO.
\n

`arrival`

Type: String
\n
Required: Yes
\n
Description: Destination airport’s three-letter IATA code, such as JFK.
\n

`date`

Type: Object
\n
Required: Yes
\n
Description: Travel date to search.
\n
Constraint: Must represent exactly one date. Date ranges are not supported.
\n

`task_id`

Type: String
\n
Required: Yes
\n
Description: Client-defined identifier used to track a search and retrieve its results from the backend.
\n
Usage: Include the task_id when requesting the completed search results. When a search is divided into multiple program batches, reuse the same task_id to group the results under a single identifier. All requests sharing a task_id must use the same travel date.
\n

\n","urlObject":{"protocol":"https","path":["flight_trigger","search_real_time"],"host":["apisv2","awardtoolapi","com"],"query":[],"variable":[]}},"response":[{"id":"2b132b85-cb3c-48fb-ad28-a1a211b0b4b8","name":"Real-time Search API - Crawler Trigger","originalRequest":{"method":"POST","header":[{"key":"sec-ch-ua","value":"\"Google Chrome\";v=\"119\", \"Chromium\";v=\"119\", \"Not?A_Brand\";v=\"24\"","disabled":true},{"key":"DNT","value":"1","disabled":true},{"key":"sec-ch-ua-mobile","value":"?0","disabled":true},{"key":"User-Agent","value":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36","disabled":true},{"key":"Content-Type","value":"application/json","disabled":true},{"key":"Referer","value":"http://localhost:5173/","disabled":true},{"key":"Authentication","value":"eyJraWQiOiIzRGZJWWhXODVoYkxtRVYrZXp1ZmM1SEJrUUl2bTczSkZCVUVHYklidDUwPSIsImFsZyI6IlJTMjU2In0.eyJhdF9oYXNoIjoiU0FiWG4tZ3FPcGtTa1FiOVRRUXF3USIsInN1YiI6IjE0Mjg1NGQ4LTEwZTEtNzBmOS1iZGJiLTk0ZDE2N2E0ZmJjMiIsImNvZ25pdG86Z3JvdXBzIjpbInVzLWVhc3QtMV9CUDdGMHBjaUZfR29vZ2xlIl0sImVtYWlsX3ZlcmlmaWVkIjpmYWxzZSwiaXNzIjoiaHR0cHM6XC9cL2NvZ25pdG8taWRwLnVzLWVhc3QtMS5hbWF6b25hd3MuY29tXC91cy1lYXN0LTFfQlA3RjBwY2lGIiwiY29nbml0bzp1c2VybmFtZSI6Imdvb2dsZV8xMDExNjI3OTY5OTY5MDkxNTE3NTgiLCJvcmlnaW5fanRpIjoiMjc0OWVhZWMtMmU5NS00Mjk3LTk1ODgtM2U0ZmMyZTIzOTU0IiwiYXVkIjoiMmx1NTk0bmF2ZmNobHRrb3BxbG1rOGx1YzciLCJpZGVudGl0aWVzIjpbeyJ1c2VySWQiOiIxMDExNjI3OTY5OTY5MDkxNTE3NTgiLCJwcm92aWRlck5hbWUiOiJHb29nbGUiLCJwcm92aWRlclR5cGUiOiJHb29nbGUiLCJpc3N1ZXIiOm51bGwsInByaW1hcnkiOiJ0cnVlIiwiZGF0ZUNyZWF0ZWQiOiIxNjkzMDg4NjM4NDI5In1dLCJ0b2tlbl91c2UiOiJpZCIsImF1dGhfdGltZSI6MTcwMTM5NjU3OSwiZXhwIjoxNzAyMjEwMjU4LCJpYXQiOjE3MDIyMDY2NTgsImp0aSI6IjVhNzZkNzI1LTQ0YmEtNDJmOS04OGI0LWIzNDU2YzU1ODcxZiIsImVtYWlsIjoieWh5bGlmZTZAZ21haWwuY29tIn0.YCGIG_s9vs-dhRAUPYC2d0tpoPFj4bqX9MnBJFeduKlZeBvi4gteNbRTSXtPhbfXbdUivELqT2rv8lqc4_bOgGH5w02hzBMetXzfEUgRmZQ4Fxh38lBjXxF-7a68ecCBPLQ90ERSiVXxWPLmY7yH6a1atOjNy-__tN_WlOD1W8ivAtEaiiNgceOMN6D4-pGYmcBL5re1zn8FLSHah-edttD1HqvZI-mbfSGXPvF1eTEPbwRv45Dv2x60v9zUbAFTP7-s9T5XISB_jBfB0PG0TKaj6KRBahP0kp3Z121o5PgmK1UZXRqZd6YSCrH30SS5XLlr7CND2e-z5Xs9kjyzIA","disabled":true},{"key":"sec-ch-ua-platform","value":"\"macOS\"","disabled":true}],"body":{"mode":"raw","raw":"{\n \"date\": \"2026-12-06\", // Travel date in YYYY-M-D format\n \"origin\": \"JFK\", // Origin airport code\n \"destination\": \"LHR\", // Destination airport code\n \"pax\": 2, // Number of passengers\n \"programs\": [\"UA\", \"AC\", \"AA\", \"DL\", \"KL\", \"TK\"],\n \"cabins\": [\"Economy\", \"Premium Economy\", \"Business\", \"First\"],\n \"task_id\": \"db80320421-ffd0-4301c-80f6-123c93097031de2d\", //Create uuid for each request, if \n \"api_key\": \"YOUR_API_KEY\"\n}","options":{"raw":{"language":"json"}}},"url":"https://apis.awardtool.com/flight_trigger/search_real_time"},"status":"OK","code":200,"_postman_previewlanguage":"","header":[{"key":":status","value":200},{"key":"date","value":"Thu, 16 Jul 2026 04:28:58 GMT"},{"key":"content-type","value":"application/json"},{"key":"access-control-allow-origin","value":""},{"key":"access-control-allow-credentials","value":"true"},{"key":"access-control-allow-methods","value":"GET,POST,OPTIONS"},{"key":"access-control-allow-headers","value":"Content-Type,Authorization,X-Requested-With,authentication,x-unique-id,Origin"},{"key":"vary","value":"Origin"},{"key":"server","value":"cloudflare"},{"key":"x-do-orig-status","value":"200"},{"key":"x-do-app-origin","value":"4720bd80-5f8a-4ea8-afe1-7b723a01d84a"},{"key":"cache-control","value":"private"},{"key":"cf-cache-status","value":"DYNAMIC"},{"key":"set-cookie","value":"__cf_bm=hY3lg4uE1W_YLLnoIH37VeIhvhdC_9lW4TgGl634UI4-1784176138.5186756-1.0.1.1-2xIjUydBiJkUCHvpu4k.2WFuXIKidR6EK0uGFXRDMOdj3stAnHgJhnvmTtyvTOoYPVNjN6y2OgkP_qZCNdvQ0YXoLaE81R7l27ZFi2ckQaic6.M.5gilkATqN49uHyOG; HttpOnly; SameSite=None; Secure; Path=/; Domain=apis.awardtool.com; Expires=Thu, 16 Jul 2026 04:58:58 GMT"},{"key":"content-encoding","value":"br"},{"key":"cf-ray","value":"a1be4361bb085bc0-SJC"},{"key":"alt-svc","value":"h3=\":443\"; ma=86400"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n \"machine\": \"APP_PLATFORM\",\n \"message\": \"exit_early\",\n \"status\": 200\n}"}],"_postman_id":"5cdc7f8c-c595-4bd4-86a7-d9f68f29de7d"},{"name":"Real-time Search API - Data Retrieval","id":"4996315c-5f9a-4f0e-8eca-0e4facf3dc9f","protocolProfileBehavior":{"disableBodyPruning":true,"disabledSystemHeaders":{"content-length":true,"content-type":true,"accept-encoding":true,"user-agent":true}},"request":{"method":"POST","header":[{"key":"accept","value":"*/*"},{"key":"accept-language","value":"en-US,en;q=0.9,zh-CN;q=0.8,zh-TW;q=0.7,zh;q=0.6"},{"key":"content-type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"task_id\": \"9a63f64b-1a3f-4d32-906d-c68aaf77c429\",\n \"api_key\": \"YOU_API_KEY\"\n}"},"url":"https://apisv2.awardtoolapi.com/flight_retrieval/search_result","description":"

Overview

Retrieve Real-Time Search Results

Returns the latest available results for a previously submitted real-time search task. Because searches are processed asynchronously, clients can poll this endpoint using the original task_id until all program-level searches are complete.

Each response contains:

Award availability collected so far
\n
Completed program-level search units
\n
Task status and elapsed time
\n
Metadata used to determine whether polling should continue
\n

Results may arrive incrementally. Clients should aggregate the results returned across polling requests.

Request Fields

`task_id`

Type: String
\n
Required: Yes
\n
Description: Client-assigned identifier used to track a search and retrieve its results.
\n
Constraint: Must match the task_id supplied in the original real-time search request.
\n

`api_key`

Type: String
\n
Required: Yes
\n
Description: API key used to authenticate the request.
\n

Task Constraints

A client-defined task_id must be included in the original search request before results can be retrieved through this endpoint.

A task may include either:

Up to two travel dates across a maximum of 10 unique loyalty programs; or
\n
One travel date across all supported loyalty programs.
\n

Clients may poll this endpoint repeatedly until all searches associated with the task are complete.

Response Fields

`result`

Type: Array of objects
\n
Description: Award-flight results returned during the current retrieval request.
\n
Notes: Results may be returned incrementally. Clients should aggregate results across polling responses and account for possible duplicate records.
\n

`program_done`

Type: Array of strings
\n
Description: Program-level search units that have completed processing and are represented in the results available so far.
\n
Format:
\n

program|origin|destination|pax|date\n\n

Example:

DL|JFK|LHR|1|2024-02-14\n\n

In this example:

DL — Loyalty-program code
\n
JFK — Origin airport
\n
LHR — Destination airport
\n
1 — Number of passengers
\n
2024-02-14 — Travel date
\n

`finish`

Type: Boolean
\n
Description: Indicates whether the client should continue polling.
\n
Values:
\n
- true — More processing or results remain. Continue polling.
  \n
- false — The task is fully complete. No additional results will be returned.
  \n
\n

\n

Continue polling while finish is true. Stop when it becomes false.

`time_elapsed`

Type: Number
\n
Description: Number of seconds elapsed since task processing began.
\n

`has_next`

Description: Reserved for internal use. Clients should ignore this field.

`task_done`

Description: Reserved for internal use. Clients should ignore this field.

Result Object Fields

Each object in result represents an award-flight itinerary.

`date`

Type: String
\n
Description: Travel date in YYYY-MM-DD format.
\n

`award_points`

Type: Integer
\n
Description: Points required for a one-way award ticket for one adult.
\n

`surcharge`

Type: Number
\n
Description: Taxes and carrier-imposed fees associated with the award ticket.
\n

`cabin_type`

Type: String
\n
Description: Cabin class associated with the itinerary. Mixed-cabin itineraries may include multiple cabin names joined with an ampersand, such as Economy & Business.
\n

`airline_name`

Type: String
\n
Description: Airline or airlines operating the itinerary.
\n
Notes: For itineraries involving multiple airlines, names are joined with an ampersand, such as American Airlines & United Airlines.
\n

`seats`

Type: Integer
\n
Description: Number of award seats known to be available at the displayed price.
\n
Notes:
\n
- This field is available only for supported loyalty programs.
  \n
- A value of -1 indicates that seat availability is unknown.
  \n
\n

`fare`

Type: Object
\n
Description: Itinerary-level information, including total travel time and flight segments.
\n

`fare.products`

Type: Array of objects
\n
Description: Ordered list of flight segments that make up the itinerary. Each object contains information about an individual flight leg, such as its airports, schedule, airline, flight number, aircraft, cabin, and duration.
\n

Recommended Integration Flow

Submit one or more real-time search requests using a client-defined task_id.
\n
Call this endpoint with the same task_id.
\n
Store or aggregate the records returned in result.
\n
Continue polling while finish is true.
\n
Stop polling when finish becomes false.
\n

\n","urlObject":{"protocol":"https","path":["flight_retrieval","search_result"],"host":["apisv2","awardtoolapi","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"4996315c-5f9a-4f0e-8eca-0e4facf3dc9f"},{"name":"Program Accuracy Stats","id":"d9a79b98-b183-4c66-b92b-72952d141cb1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"authority","value":"flight.awardinsightapi.com"},{"key":"accept","value":"application/json, text/plain, */*"},{"key":"accept-language","value":"en-US,en;q=0.9,zh-CN;q=0.8,zh-TW;q=0.7,zh;q=0.6"},{"key":"content-type","value":"application/json"},{"key":"sec-ch-ua","value":"\"Chromium\";v=\"116\", \"Not)A;Brand\";v=\"24\", \"Google Chrome\";v=\"116\""}],"body":{"mode":"raw","raw":"{\n \"program\": \"AA\",\n \"api_key\": \"YOUR_API_KEY\"\n}","options":{"raw":{"language":"json"}}},"url":"https://apisv2.awardtoolapi.com/api/program_stats_api","description":"

Overview

The Program Accuracy Statistics API provides program-level accuracy metrics for supported airline loyalty programs. This endpoint allows clients to retrieve the current accuracy score for a specific program, enabling transparency into data reliability and operational performance.

Accuracy metrics are calculated continuously based on internal validation and monitoring systems and are intended to help partners assess data quality for routing, analytics, and decision-making workflows.

Authentication

All requests must include a valid api_key.

Request

Request Body

{\n  \"program\": \"AA\",\n  \"api_key\": \"YOUR_API_KEY\"\n}\n\n

Request Fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`program`	String	Yes	Airline loyalty program code (e.g., `AA`, `DL`, `UA`).
`api_key`	String	Yes	API key used to authenticate the request.

Response

Successful Response

{\n  \"accuracy\": \"99.77614326830829\",\n  \"machine\": \"APP_PLATFORM\",\n  \"status\": 200\n}\n\n

Response Fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
`accuracy`	String	Accuracy percentage for the specified program.
`machine`	String	Source system or platform used to compute the metric.
`status`	Number	HTTP-like status code indicating request success.

Note: Accuracy values are expressed as percentages and may change over time as new data is processed.

Error Handling

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Description
400	Invalid or missing request parameters
401	Invalid API key
404	Program not supported
500	Internal server error

Usage Notes

Accuracy metrics are program-specific and should be interpreted independently.
\n
This endpoint is intended for monitoring, analytics, and transparency, not for real-time availability decisions.
\n
Accuracy values are informational and may vary as systems and airline sources change.
\n

Example Use Cases

Display program reliability indicators in partner dashboards
\n
Filter or weight award search results based on program accuracy
\n
Monitor data quality trends over time
\n

\n","urlObject":{"protocol":"https","path":["api","program_stats_api"],"host":["apisv2","awardtoolapi","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"d9a79b98-b183-4c66-b92b-72952d141cb1"},{"name":"API key usage","id":"389cae93-cb97-4f71-98d4-b3c0fb2882d9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"api_key\": \"YOUR_API_KEY\"\n}","options":{"raw":{"language":"json"}}},"url":"https://apisv2.awardtoolapi.com/api/api_usage","description":"

Overview

The API Usage Metrics API provides detailed, per-day usage statistics associated with a specific API key. This endpoint enables clients to monitor and audit their API consumption across supported AwardTool services, including Panorama data endpoints and real-time search operations.

Usage data is aggregated by date and is intended for billing validation, quota monitoring, and operational transparency.

Authentication

All requests must include a valid api_key.

Request

Request Body

{\n  \"api_key\": \"YOUR_API_KEY\"\n}\n\n

Request Fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`api_key`	String	Yes	API key for which usage statistics are being requested.

Response

Successful Response

{\n  \"data\": [\n    {\n      \"date\": \"2023-12-11\",\n      \"api_key\": \"683de76f-2e37-4253-8dbf-fd88b507bbc4\",\n      \"panorama_flight_data\": 1,\n      \"panorama_calendar_data\": 1,\n      \"panorama_route_data\": 1,\n      \"real_time_search\": 3\n    },\n    {\n      \"date\": \"2023-12-12\",\n      \"api_key\": \"683de76f-2e37-4253-8dbf-fd88b507bbc4\",\n      \"panorama_calendar_data\": 1,\n      \"api_usage\": 2\n    }\n  ],\n  \"status\": 200\n}\n\n

Response Fields

Top-Level Fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
`data`	Array	List of daily usage records associated with the API key.
`status`	Number	HTTP-like status code indicating request success.

Daily Usage Record Fields

Each object in the data array represents usage metrics for a specific date.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description
`date`	String	Usage date (YYYY-MM-DD).
`api_key`	String	API key associated with the usage record.
`panorama_flight_data`	Number	Number of Panorama flight data requests.
`panorama_calendar_data`	Number	Number of Panorama calendar data requests.
`panorama_route_data`	Number	Number of Panorama route data requests.
`real_time_search`	Number	Number of real-time search requests.
`api_usage`	Number	Number of API usage retrieval calls (this endpoint).

Note: Fields may vary by date depending on which services were accessed on that day. Missing fields indicate zero usage for that category.

Usage Notes

Usage data is aggregated per day and per API key.
\n
Counts reflect successful API calls only.
\n
This endpoint is intended for monitoring and reporting purposes and does not modify usage quotas.
\n
Historical usage availability may be subject to retention limits.
\n

Common Use Cases

Validate monthly usage against contractual limits
\n
Power internal billing and invoicing workflows
\n
Monitor consumption trends and optimize API usage
\n
Display usage dashboards for enterprise clients
\n

Error Handling

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Status	Description
400	Invalid or missing API key
401	Unauthorized access
500	Internal server error

","urlObject":{"protocol":"https","path":["api","api_usage"],"host":["apisv2","awardtoolapi","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"389cae93-cb97-4f71-98d4-b3c0fb2882d9"}]}