cotera
Logo

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)
    • priceRounded object (nullable): Rounded price for display
      • currencyCode string (nullable): Currency code
      • units number (nullable): Price units
      • nanos number (nullable): Price nanos

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
    • 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
      • 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
      • totalTime number (nullable): Total leg duration in minutes
      • flightStops array (nullable): Stop information
      • amenities array (nullable): Available amenities
      • departureTerminal string (nullable): Departure terminal
    • 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
      • personalItem boolean (nullable): Personal item allowed
    • isAtolProtected boolean (nullable): ATOL protection status
    • showWarningDestinationAirport boolean (nullable): Destination warning flag
    • showWarningOriginAirport boolean (nullable): Origin warning flag
  • 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

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