Developer documentationAPI reference.
Use these resources to retrieve the flight and hotel records covered by your subscription. All requests use HTTPS and return JSON.
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
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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.
{
"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.