Flight Search
Authentication Type: API Key
Description: Search for flights and get pricing details from Booking.com.
Search Flights
Search for flight deals between two locations.
Operation Type: Mutation (Write)
Parameters:
- fromId
string(required): From/Departure location ID (e.g., OMA.AIRPORT) - toId
string(required): To/Arrival location ID (e.g., LGA.AIRPORT) - departDate
string(required): Departure date in YYYY-MM-DD format - returnDate
string(nullable): Return date in YYYY-MM-DD format (optional for one-way) - stops
string(nullable): Number of stops: none, 0, 1, 2 - pageNo
string(nullable): Page number for pagination - adults
string(nullable): Number of adults 18+ (default: 1) - children
string(nullable): Number of children under 18 - sort
string(nullable): Sort order: BEST, CHEAPEST, FASTEST - cabinClass
string(nullable): Cabin class: ECONOMY, PREMIUM_ECONOMY, BUSINESS, FIRST - currencyCode
string(nullable): Currency code (e.g., USD)
Returns:
- flightDeals
array of objects(nullable): Array of flight deals- key
string(nullable): Deal identifier - offerToken
string(nullable): Token for retrieving detailed flight information - price
object(nullable): Flight price- currencyCode
string(nullable): Currency code - units
number(nullable): Price units - nanos
number(nullable): Price nanos (fractional part)
- currencyCode
- priceRounded
object(nullable): Rounded price for display- currencyCode
string(nullable): Currency code - units
number(nullable): Price units - nanos
number(nullable): Price nanos
- currencyCode
- key
Example Usage:
{
"fromId": "JFK.AIRPORT",
"toId": "LAX.AIRPORT",
"departDate": "2024-06-15",
"returnDate": "2024-06-22",
"stops": "1",
"pageNo": "1",
"adults": "2",
"children": "0",
"sort": "CHEAPEST",
"cabinClass": "ECONOMY",
"currencyCode": "USD"
}
Flight Details
Get comprehensive flight information including segments, legs, airports, carriers, timing, and pricing breakdown for a specific flight offer.
Operation Type: Mutation (Write)
Parameters:
- token
string(required): Offer token from flight search results - currencyCode
string(nullable): Currency code (e.g., USD)
Returns:
- token
string(nullable): Flight offer token - segments
array of objects(nullable): Flight segments- departureAirport
object(nullable): Departure airport information- type
string(nullable): Airport type - code
string(nullable): Airport code - name
string(nullable): Airport name - city
string(nullable): City name - cityName
string(nullable): Full city name - country
string(nullable): Country code - countryName
string(nullable): Country name - province
string(nullable): Province/state - provinceCode
string(nullable): Province/state code
- type
- arrivalAirport
object(nullable): Arrival airport information (same structure as departureAirport) - departureTime
string(nullable): Departure time - arrivalTime
string(nullable): Arrival time - legs
array of objects(nullable): Individual flight legs- departureTime
string(nullable): Leg departure time - arrivalTime
string(nullable): Leg arrival time - departureAirport
object(nullable): Leg departure airport - arrivalAirport
object(nullable): Leg arrival airport - cabinClass
string(nullable): Cabin class for this leg - flightInfo
object(nullable): Flight information- facilities
array of strings(nullable): Available facilities - flightNumber
number(nullable): Flight number - planeType
string(nullable): Aircraft type - carrierInfo
object(nullable): Carrier details- operatingCarrier
string(nullable): Operating airline - marketingCarrier
string(nullable): Marketing airline - operatingCarrierDisclosureText
string(nullable): Disclosure text
- operatingCarrier
- facilities
- carriers
array of strings(nullable): Carrier codes - carriersData
array of objects(nullable): Detailed carrier information- name
string(nullable): Carrier name - code
string(nullable): Carrier code - logo
string(nullable): Carrier logo URL
- name
- totalTime
number(nullable): Total leg duration in minutes - flightStops
array(nullable): Stop information - amenities
array(nullable): Available amenities - departureTerminal
string(nullable): Departure terminal
- departureTime
- totalTime
number(nullable): Total segment duration in minutes - travellerCheckedLuggage
array(nullable): Checked luggage allowances - travellerCabinLuggage
array of objects(nullable): Cabin luggage allowances- travellerReference
string(nullable): Traveller reference - luggageAllowance
object(nullable): Luggage allowance details- luggageType
string(nullable): Type of luggage - maxPiece
number(nullable): Maximum pieces allowed
- luggageType
- personalItem
boolean(nullable): Personal item allowed
- travellerReference
- isAtolProtected
boolean(nullable): ATOL protection status - showWarningDestinationAirport
boolean(nullable): Destination warning flag - showWarningOriginAirport
boolean(nullable): Origin warning flag
- departureAirport
- priceBreakdown
object(nullable): Detailed pricing information- total
object(nullable): Total price - baseFare
object(nullable): Base fare - fee
object(nullable): Fees - tax
object(nullable): Taxes - totalRounded
object(nullable): Rounded total - discount
object(nullable): Discounts applied
- total
Example Usage:
{
"token": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJmbGlnaHRfb2ZmZXIiLCJpYXQiOjE2...",
"currencyCode": "USD"
}
Common Use Cases
Travel Planning:
- Search for flights between specific airports with flexible date ranges and passenger counts
- Compare flight options by price, duration, and number of stops for optimal travel planning
- Filter flights by cabin class and sort by preferences (cheapest, fastest, best overall value)
Travel Booking Integration:
- Retrieve detailed flight information including segments, carriers, and amenities for booking confirmation
- Access comprehensive pricing breakdowns with taxes, fees, and base fares for transparent pricing
- Get luggage allowance information for different traveller types and cabin classes
Price Comparison and Analytics:
- Analyze flight pricing trends across different routes, dates, and booking parameters
- Compare carrier options with detailed information about aircraft types, facilities, and services
- Track flight availability and pricing changes using pagination for comprehensive market analysis
Corporate Travel Management:
- Search for business travel options with specific cabin class requirements and booking policies
- Retrieve detailed flight segments and timing information for travel approval and expense reporting
- Access carrier and airport details for travel policy compliance and preferred vendor trac