POSTFlight Search
Search for award flight availability across 40+ airline loyalty programs. Returns paginated results with miles, tax, cabin, and transfer partner details.
POST https://ai-api.pointsyeah.com/explorer/search
The explorer API holds approximately 61 days of forward-looking data.Use `collection: false` for standard search. Set `collection: true` to include results from partner collections.
Parameters
ParameterValue
departureobjectrequired
Departure location filter. At least one sub-field should be populated.
airportsarray
IATA airport codes, e.g. ["JFK", "LAX"]
countriesarray
Country codes
continentsarray
Continent codes, e.g. ["AS", "EU"]
regionsarray
Region identifiers
statesarray
US state codes
arrivalobjectrequired
Arrival location filter. Same structure as departure.
airportsarray
IATA airport codes
countriesarray
Country codes
continentsarray
Continent codes
regionsarray
Region identifiers
statesarray
US state codes
start_datedaterequired
Start of search window, YYYY-MM-DD format.
end_datedaterequired
End of search window, YYYY-MM-DD format.
cabinsarray
Cabin classes to filter by. Values: Economy, Premium, Business, First.Default: ["Economy"]
sortstring
Sort order. Prefix with - for descending.Default: -updated_at
miles-miles-updated_attax-taxduration-duration
stopsnumber
Maximum number of stops. Omit for any.
max_durationnumber
Maximum flight duration in minutes.
min_durationnumber
Minimum flight duration in minutes.
max_pointsnumber
Maximum miles/points required.
min_pointsnumber
Minimum miles/points required.
banksarray
Bank programs to filter by (e.g. Chase, Amex, Bilt, Capital One, Citi).
programsarray
Airline loyalty programs to filter by (e.g. AS, UA, AA, DL).
premium_cabin_percentagenumber
Minimum premium cabin percentage (0-100). Only applies when Business or First cabin is selected.
tripstring
Type of travel filter.
max_taxnumber
Maximum tax in USD.
min_taxnumber
Minimum tax in USD.
seatsnumber
Number of passengers (1-9).Default: 1
weekend_onlyboolean
Only return weekend departures.Default: false
collectionboolean
Include partner collection results.Default: false
paginationobjectrequired
Pagination controls.
pagenumberrequired
Page number (1-based).Default: 1
page_sizenumberrequired
Results per page.Default: 18