Query Leg
One way or return
To search for one way flights, a queryLeg list with only 1 leg can be specified. If return prices are required, specify a queryLeg list with 2 legs.
Date types
Each queryLeg must only have one date type such as: dateRange or fixedDate or anytime.
A summary of the date types and their functions:
| Date type | Description |
|---|---|
dateRange | A range of dates to search for flights for. Will search for prices from the first to last date of each month |
fixedDate | A specific date to search for flights for. |
anytime | Will return best quotes for a given route. |
See the Flights Indicative API reference for more details.
Sample date types
{
"queryLegs": [
{
...
"anytime":true
...
}
]
}
Or
{
"queryLeg": [
{
...
"fixedDate": {
"year": 2022,
"month": 1,
"day": 1
}
...
}
]
}
Or
{
"queryLeg": [
{
...
"dateRange": {
"startDate":{
"month": 7,
"year": 2022
},
"endDate":{
"month": 8,
"year": 2022
}
}
...
}
]
}
Origin and destination place types
The flight indicative prices api accepts IATA and entityId place types at the following levels:
- airports
- cities
- nation or territories
Continent type places are not valid. (E.g. 205351567 - North America).
Airports and cities can be either IATA and entityId. (E.g LHR - London Heathrow, LON - London)
Nations or territories do not have IATA codes and therefore need to be inputted as entityId.
Data for IATA and entityId can be found in the Geo API reference.
Sample date types
{
"queryLegs": [
{
...
"originPlace": {
"queryPlace":{
// EntityId for the United States
"entityId": "29475087"
}
}
...
}
]
}
{
"queryLegs": [
{
...
"destinationPlace": {
"queryPlace":{
// IATA code for London Heathrow Airport
"iata": "LHR"
}
}
...
}
]
}