Developer documentation

API reference.

Use these resources to retrieve the flight and hotel records covered by your subscription. All requests use HTTPS and return JSON.

Download OpenAPI specification

Authentication

Example base URL
https://api.bestawardintelligence.com

Use the endpoint and credentials provided with your subscription. Keep your key on your server and include it in the JSON body as api_key.

Request subscription access
Example ยท nightly hotel rates
curl --request POST "https://api.bestawardintelligence.com/api/hotel_calendar" \
  --header "Content-Type: application/json" \
  --data '{"hotel_id":"hyatt_kauai","api_key":"YOUR_API_KEY"}'

Flight award pricing

Sample record and field definitions

Start a flight search

Search one departure date. Use three-letter airport codes, licensed program codes and the number of travelers as a string.

Save the returned task_id to retrieve priced itineraries.

POST /flight_trigger/search_real_time
{
  "origin": "JFK",
  "destination": "LHR",
  "date": "2027-02-15",
  "programs": [
    "AA"
  ],
  "cabins": [
    "Business"
  ],
  "pax": "1",
  "api_key": "YOUR_API_KEY"
}

Read flight results

Pass the task_id from the search. Collect each result batch and continue polling while finish is false.

Each result can include a loyalty program, itinerary, cabin, points, cash fees and observed seat count.

POST /flight_retrieval/search_result
{
  "task_id": "example-flight-search-01",
  "api_key": "YOUR_API_KEY"
}

Route price calendars

Sample record and field definitions

Read a route calendar

Pass the departure and arrival airport codes separated by a hyphen. The direction of travel matters.

Rows group observed award prices by date and program. Nonstop prices are reported separately when available.

POST /panorama/panorama_calendar_data
{
  "id": "SFO-JFK",
  "api_key": "YOUR_API_KEY"
}

Hotel room pricing

Sample record and field definitions

List supported properties

Send your subscription key to retrieve the property catalog available to your account.

Use the id field from a property record as hotel_id when requesting its calendar.

POST /api/hotel_all
{
  "api_key": "YOUR_API_KEY"
}

Read nightly hotel rates

Pass the full property ID, including the brand prefix, from the hotel list.

In data[0], each check-in date maps to a list of room rates. Cash-only offers can omit the points rate.

POST /api/hotel_calendar
{
  "hotel_id": "hyatt_kauai",
  "api_key": "YOUR_API_KEY"
}

Seat maps

Sample record and field definitions

Read a seat map

Supply the operating flight and airports, the departure date and a cabin code for one segment.

Match seat labels in the availability record to the layout for the flight.

POST /api/seatmap
{
  "flight": {
    "id": "VS20",
    "airlineCode": "VS",
    "flightNo": "20",
    "departureDate": "2027-02-15",
    "departure": "SFO",
    "arrival": "LHR",
    "cabinClass": "E"
  },
  "api_key": "YOUR_API_KEY"
}

Response codes

200
The request succeeded. For flight searches, check the finish field when polling results.
400
Check the JSON body, required fields and Content-Type header.
401 / 403
Verify the key is active and that your subscription includes the requested dataset.
429
Wait before retrying. Honor the Retry-After header when supplied.
502 / 504
The data service could not complete the request. Retry a read after a delay.