Flight Offers Search

swagger: '2.0'
info:
  version: 2.9.1
  title: Flight Offers Search
  x-tags:
    - '#online-retail'
    - '#mobile-services'
    - '#ama-for-dev'
  x-status: validated
  x-release-note:
    2.9.0:
      - Add lastTicketingDateTime attribute in the Flight-Offer
    2.8.0:
      - Add Non-stop preferred option
    2.7.0:
      - Add new source "NDC" - **only available in Enterprise**
    2.6.0:
      - Add Margins and Discounts content from Margin Manager product - **only available in Enterprise**
    2.5.0:
      - Add Expanded parameters criterias in flight-offers search
    2.4.0:
      - Add new sources "LTC" and "EAC" - **only available in Enterprise**
    2.3.0:
      - Add Farerules into POST Search flight-offer reply
    2.2.0:
      - Add maxPrice filtering
    2.1.0:
      - Add currencies, aircraft and carriers dictionary
    2.0.0:
      - Initial Version
      - Includes search and price flight offer
  description: |2-

    Before using this API, we recommend you read our **[Authorization Guide](https://developers.amadeus.com/self-service/apis-docs/guides/authorization-262)** for more information on how to generate an access token. 

    Please also be aware that our test environment is based on a subset of the production, if you are not returning any results try with big cities/airports like LON (London) or NYC (New-York).
host: test.api.amadeus.com
basePath: /v2
schemes:
  - https
consumes:
  - application/vnd.amadeus+json
produces:
  - application/vnd.amadeus+json
paths:
  /shopping/flight-offers:
    post:
      tags:
        - Shopping
      operationId: searchFlightOffers
      summary: Amadeus Return List of Flight Offers Based on Posted Searching Criteria.
      parameters:
        - $ref: '#/parameters/getOverride'
        - name: getFlightOffersBody
          description: list of criteria to retrieve a list of flight offers
          in: body
          required: true
          schema:
            $ref: '#/definitions/GetFlightOffersQuery'
      responses:
        '200':
          $ref: '#/responses/returnAirOffers'
        '400':
          $ref: '#/responses/400_Search'
        default:
          $ref: '#/responses/500'
      description: ''
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    get:
      tags:
        - Shopping
      operationId: getFlightOffers
      summary: Amadeus Return List of Flight Offers Based on Searching Criteria.
      parameters:
        - name: originLocationCode
          in: query
          description: city/airport [IATA code](http://www.iata.org/publications/Pages/code-search.aspx) from which the traveler will depart, e.g. BOS for Boston
          required: true
          type: string
          pattern: '[A-Z]{3}'
          x-example: SYD
        - name: destinationLocationCode
          in: query
          description: city/airport [IATA code](http://www.iata.org/publications/Pages/code-search.aspx) to which the traveler is going, e.g. PAR for Paris
          required: true
          type: string
          pattern: '[A-Z]{3}'
          x-example: BKK
        - name: departureDate
          in: query
          description: the date on which the traveler will depart from the origin to go to the destination. Dates are specified in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) YYYY-MM-DD format, e.g. 2017-12-25
          required: true
          type: string
          format: date
          x-example: '2023-05-02'
        - name: returnDate
          in: query
          description: the date on which the traveler will depart from the destination to return to the origin. If this parameter is not specified, only one-way itineraries are found. If this parameter is specified, only round-trip itineraries are found. Dates are specified in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) YYYY-MM-DD format, e.g. 2018-02-28
          required: false
          type: string
          format: date
          x-example: '2026-08-15'
        - name: adults
          in: query
          description: |-
            the number of adult travelers (age 12 or older on date of departure).

            The total number of seated travelers (adult and children) can not exceed 9.
          required: true
          type: integer
          minimum: 1
          maximum: 9
          default: 1
          x-example: 1
        - name: children
          in: query
          description: |-
            the number of child travelers (older than age 2 and younger than age 12 on date of departure) who will each have their own separate seat. If specified, this number should be greater than or equal to 0

            The total number of seated travelers (adult and children) can not exceed 9.
          required: false
          type: integer
          minimum: 0
          maximum: 9
          x-example: 0
        - name: infants
          in: query
          description: the number of infant travelers (whose age is less or equal to 2 on date of departure). Infants travel on the lap of an adult traveler, and thus the number of infants must not exceed the number of adults. If specified, this number should be greater than or equal to 0
          required: false
          type: integer
          minimum: 0
          maximum: 9
          x-example: 0
        - name: travelClass
          in: query
          description: most of the flight time should be spent in a cabin of this quality or higher. The accepted travel class is economy, premium economy, business or first class. If no travel class is specified, the search considers any travel class
          required: false
          type: string
          enum:
            - ECONOMY
            - PREMIUM_ECONOMY
            - BUSINESS
            - FIRST
          x-example: ECONOMY
        - name: includedAirlineCodes
          in: query
          description: |
            This option ensures that the system will only consider these airlines. This can not be cumulated with parameter excludedAirlineCodes.

            Airlines are specified as [IATA airline codes](http://www.iata.org/publications/Pages/code-search.aspx) and are comma-separated, e.g. 6X,7X,8X
          required: false
          type: string
          collectionFormat: csv
          pattern: '[0-9A-Z]{2}'
          x-example: string-value
        - name: excludedAirlineCodes
          in: query
          description: |
            This option ensures that the system will ignore these airlines. This can not be cumulated with parameter includedAirlineCodes.

            Airlines are specified as [IATA airline codes](http://www.iata.org/publications/Pages/code-search.aspx) and are comma-separated, e.g. 6X,7X,8X
          required: false
          type: string
          collectionFormat: csv
          pattern: '[0-9A-Z]{2}'
          x-example: string-value
        - name: nonStop
          in: query
          description: if set to true, the search will find only flights going from the origin to the destination with no stop in between
          required: false
          type: boolean
          default: false
          x-example: true
        - name: currencyCode
          in: query
          description: the preferred currency for the flight offers. Currency is specified in the [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format, e.g. EUR for Euro
          required: false
          type: string
          pattern: '[A-Z]{3}'
          x-example: EUR
        - name: maxPrice
          in: query
          description: maximum price per traveler. By default, no limit is applied. If specified, the value should be a positive number with no decimals
          required: false
          type: integer
          minimum: 1
          x-example: '199.50'
        - name: max
          in: query
          description: maximum number of flight offers to return. If specified, the value should be greater than or equal to 1
          required: false
          type: integer
          minimum: 1
          default: 250
          x-example: 1
      responses:
        '200':
          $ref: '#/responses/GETAirOffersReply'
        '400':
          $ref: '#/responses/400_Search'
        default:
          $ref: '#/responses/500'
      description: ''
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
definitions:
  Error_400:
    type: object
    properties:
      errors:
        type: array
        items:
          $ref: '#/definitions/Issue'
    required:
      - errors
    example:
      errors:
        - status: 400
          code: 477
          title: INVALID FORMAT
          detail: invalid query parameter format
          source:
            parameter: airport
            example: CDG
  Error_500:
    type: object
    properties:
      errors:
        type: array
        items:
          $ref: '#/definitions/Issue'
    required:
      - errors
    example:
      errors:
        - status: 500
          code: 141
          title: SYSTEM ERROR HAS OCCURRED
  Issue:
    type: object
    properties:
      status:
        description: the HTTP status code applicable to this error
        type: integer
        example: 1
      code:
        description: an application-specific error code
        type: integer
        format: int64
        example: 1
      title:
        description: a short summary of the error
        type: string
        example: string-value
      detail:
        description: explanation of the error
        type: string
        example: string-value
      source:
        type: object
        title: Issue_Source
        description: an object containing references to the source of the error
        maxProperties: 1
        properties:
          pointer:
            description: a JSON Pointer [RFC6901] to the associated entity in the request document
            type: string
            example: string-value
          parameter:
            description: a string indicating which URI query parameter caused the issue
            type: string
            example: string-value
          example:
            description: a string indicating an example of the right value
            type: string
            example: string-value
  Collection_Meta:
    title: Collection_Meta
    properties:
      count:
        type: integer
        example: 1
      oneWayCombinations:
        type: array
        items:
          title: oneWayCombinations
          properties:
            originDestinationId:
              type: string
              example: '12345'
            flightOfferIds:
              type: array
              items:
                type: string
  Collection_Meta_Link:
    type: object
    title: Collection_Meta
    properties:
      count:
        type: integer
        example: 1
      links:
        type: object
        title: CollectionLinks
        properties:
          self:
            type: string
            format: uri
            example: https://test.api.amadeus.com/v1/area/resources?...
          next:
            type: string
            format: uri
            example: https://test.api.amadeus.com/v1/area/resources?...
          previous:
            type: string
            format: uri
            example: https://test.api.amadeus.com/v1/area/resources?...
          last:
            type: string
            format: uri
            example: https://test.api.amadeus.com/v1/area/resources?...
          first:
            type: string
            format: uri
            example: https://test.api.amadeus.com/v1/area/resources?...
          up:
            type: string
            format: uri
            example: https://test.api.amadeus.com/v1/area/resources?...
        example:
          self: https://test.api.amadeus.com/v1/area/resources?param=value
  LocationEntry:
    additionalProperties:
      $ref: '#/definitions/LocationValue'
  AircraftEntry:
    additionalProperties:
      description: the manufacturer/model of aircraft
      type: string
  CurrencyEntry:
    additionalProperties:
      type: string
      example: EUR
  CarrierEntry:
    additionalProperties:
      description: the carrier name
      type: string
  FlightSegment:
    type: object
    description: defining a flight segment; including both operating and marketing details when applicable
    properties:
      departure:
        $ref: '#/definitions/FlightEndPoint'
      arrival:
        $ref: '#/definitions/FlightEndPoint'
      carrierCode:
        type: string
        description: providing the airline / carrier code
        minLength: 1
        maxLength: 2
        example: DL
      number:
        type: string
        description: the flight number as assigned by the carrier
        minLength: 1
        maxLength: 4
        example: '212'
      aircraft:
        $ref: '#/definitions/AircraftEquipment'
      operating:
        $ref: '#/definitions/OperatingFlight'
      duration:
        type: string
        description: stop duration in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) PnYnMnDTnHnMnS format, e.g. PT2H10M
        example: PT2H10M
      stops:
        type: array
        description: information regarding the different stops composing the flight segment. E.g. technical stop, change of gauge...
        items:
          $ref: '#/definitions/FlightStop'
  OriginalFlightEndPoint:
    type: object
    description: departure or arrival information
    properties:
      iataCode:
        description: '[IATA airline codes](http://www.iata.org/publications/Pages/code-search.aspx)'
        type: string
        example: JFK
      terminal:
        description: terminal name / number
        type: string
        example: T2
  FlightEndPoint:
    title: FlightEndPoint
    description: departure or arrival information
    allOf:
      - $ref: '#/definitions/OriginalFlightEndPoint'
      - type: object
        properties:
          at:
            description: local date and time in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) YYYY-MM-ddThh:mm:ss format, e.g. 2017-02-10T20:40:00
            type: string
            format: date-time
            example: '2017-10-23T20:00:00'
  OriginalFlightStop:
    description: details of stops for direct or change of gauge flights
    type: object
    properties:
      iataCode:
        description: '[IATA airline codes](http://www.iata.org/publications/Pages/code-search.aspx)'
        type: string
        example: JFK
      duration:
        type: string
        description: stop duration in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) PnYnMnDTnHnMnS format, e.g. PT2H10M
        example: PT2H10M
  FlightStop:
    title: FlightStop
    description: details of stops for direct or change of gauge flights
    allOf:
      - $ref: '#/definitions/OriginalFlightStop'
      - type: object
        properties:
          arrivalAt:
            description: arrival at the stop in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) YYYY-MM-ddThh:mm:ss format, e.g. 2017-02-10T20:40:00
            type: string
            format: date-time
            example: '2017-10-23T20:00:00'
          departureAt:
            description: departure from the stop in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) YYYY-MM-ddThh:mm:ss format, e.g. 2017-02-10T20:40:00
            type: string
            format: date-time
            example: '2017-10-23T20:00:00'
  AircraftEquipment:
    description: information related to the aircraft
    properties:
      code:
        type: string
        description: |
          IATA aircraft code (http://www.flugzeuginfo.net/table_accodes_iata_en.php)
        pattern: '[a-zA-Z0-9]{3}'
        example: '318'
  OperatingFlight:
    type: object
    description: information about the operating flight
    properties:
      carrierCode:
        type: string
        description: providing the airline / carrier code
        minLength: 1
        maxLength: 2
        example: DL
  Price:
    properties:
      currency:
        type: string
        example: USD
      total:
        description: Total amount paid by the user
        type: string
        example: '932.70'
      base:
        description: Amount without taxes
        type: string
        example: '632.70'
      fees:
        description: List of applicable fees
        type: array
        items:
          $ref: '#/definitions/Fee'
      taxes:
        type: array
        items:
          $ref: '#/definitions/Tax'
      refundableTaxes:
        description: The amount of taxes which are refundable
        type: string
        example: '200.00'
  Extended_Price:
    type: object
    title: Price
    description: price information
    allOf:
      - type: object
        properties:
          margin:
            description: BOOK step ONLY - The price margin percentage (plus or minus) that the booking can tolerate. When set to 0, then no price magin is tolerated.
            type: string
            example: '1.00'
          grandTotal:
            description: Total amount paid by the user (including fees and selected additional services).
            type: string
            example: '987.00'
          billingCurrency:
            description: Currency of the payment. It may be different than the requested currency
            type: string
            example: EUR
          additionalServices:
            type: array
            title: AdditionalServices
            items:
              title: AdditionalService
              type: object
              properties:
                amount:
                  type: string
                  example: '332.70'
                type:
                  $ref: '#/definitions/AdditionalServiceType'
      - $ref: '#/definitions/Price'
  Fee:
    description: a fee
    properties:
      amount:
        type: string
        example: '332.70'
      type:
        $ref: '#/definitions/FeeType'
  FeeType:
    type: string
    description: type of fee
    enum:
      - TICKETING
      - FORM_OF_PAYMENT
      - SUPPLIER
    example: TICKETING
  Tax:
    description: a tax
    type: object
    properties:
      amount:
        type: string
        example: '332.70'
      code:
        type: string
        example: MX
  TravelClass:
    description: quality of service offered in the cabin where the seat is located in this flight. Economy, premium economy, business or first class
    type: string
    enum:
      - ECONOMY
      - PREMIUM_ECONOMY
      - BUSINESS
      - FIRST
    example: PREMIUM_ECONOMY
  Co2Emission:
    type: object
    properties:
      weight:
        description: Weight of Co2 emitted for the concerned segment
        type: integer
        example: 90
      weightUnit:
        description: Code to qualify unit as pounds or kilos
        type: string
        example: KG
      cabin:
        $ref: '#/definitions/TravelClass'
  OriginDestination:
    allOf:
      - $ref: '#/definitions/OriginDestinationLight'
      - type: object
        properties:
          originRadius:
            description: |
              Include other possible locations around the point, located less than this distance in kilometers away. Max:300

              Can not be combined with "dateWindow" or "timeWindow".
            type: number
            example: 200
          alternativeOriginsCodes:
            type: array
            description: Set of alternative origin location, such as a city or an airport. Currently, only the locations defined in [IATA](http://www.iata.org/publications/Pages/code-search.aspx) are supported.
            minItems: 1
            maxItems: 2
            items:
              title: code
              type: string
            example:
              - LON
              - MUC
          destinationRadius:
            description: |
              Include other possible locations around the point, located less than this distance in kilometers away. Max:300

              Can not be combined with "dateWindow" or "timeWindow".
            type: number
            example: 200
          alternativeDestinationsCodes:
            type: array
            description: Set of alternative destination location, such as a city or an airport. Currently, only the locations defined in [IATA](http://www.iata.org/publications/Pages/code-search.aspx) are supported.
            minItems: 1
            maxItems: 2
            items:
              title: code
              type: string
          departureDateTimeRange:
            description: Approximate date and time of departure, specified as a local date and time range.
            $ref: '#/definitions/DateTimeRange'
          arrivalDateTimeRange:
            description: Approximate date and time of arrival, specified as a local date and time range.
            $ref: '#/definitions/DateTimeRange'
  OriginDestinationLight:
    type: object
    properties:
      id:
        type: string
        example: 1
      originLocationCode:
        description: Origin location, such as a city or an airport. Currently, only the locations defined in [IATA](http://www.iata.org/publications/Pages/code-search.aspx) are supported.
        type: string
        example: PAR
      destinationLocationCode:
        description: Destination location, such as a city or an airport. Currently, only the locations defined in [IATA](http://www.iata.org/publications/Pages/code-search.aspx) are supported.
        type: string
        example: NYC
      includedConnectionPoints:
        type: array
        description: List of included connections points. When an includedViaPoints option is specified, all FlightOffer returned must at least go via this Connecting Point. Currently, only the locations defined in IATA are supported. Used only by the AMADEUS provider
        minItems: 1
        maxItems: 2
        items:
          title: code
          type: string
        example:
          - MRS
      excludedConnectionPoints:
        type: array
        description: List of excluded connections points. Any FlightOffer with these connections points will be present in response. Currently, only the locations defined in IATA are supported. Used only by the AMADEUS provider
        minItems: 1
        maxItems: 3
        items:
          title: code
          type: string
        example:
          - MRS
  DateTimeRange:
    title: dateTimeRange
    allOf:
      - $ref: '#/definitions/DateTimeType'
      - type: object
        properties:
          dateWindow:
            description: |
              Either 1, 2 or 3 extra days around the local date (IxD for +/- x days - Ex: I3D), Either 1 to 3 days after the local date (PxD for +x days - Ex: P3D), or 1 to 3 days before the local date (MxD for -x days - Ex: M3D)

              Can not be combined with "originRadius" or "destinationRadius".
            type: string
            example: I3D
            pattern: ^[MPI][1-3]D
          timeWindow:
            description: |
              1 to 12 hours around (both +and -) the local time. Possibly limited by the number of extra days when specified, i.e.  in some situations, it may not be used to exceed the maximum date range. [1-12]H format, e.g. 6H

              Can not be combined with "originRadius" or "destinationRadius".
            type: string
            example: 2H
            pattern: ^([1-9]|10|11|12)H
    required:
      - date
  DateTimeType:
    type: object
    properties:
      date:
        description: Dates are specified in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) YYYY-MM-DD format, e.g. 2018-12-25
        type: string
        format: date
        example: '2018-09-22'
      time:
        description: Local time. hh:mm:ss format, e.g 10:30:00
        type: string
        example: '10:30:00'
    required:
      - date
  Extended_TravelerInfo:
    allOf:
      - $ref: '#/definitions/TravelerInfo'
    required:
      - id
      - travelerType
  TravelerInfo:
    type: object
    properties:
      id:
        type: string
        example: 1
      travelerType:
        $ref: '#/definitions/TravelerType'
      associatedAdultId:
        type: string
        description: if type="HELD_INFANT", corresponds to the adult travelers's id who will share the seat
        example: '12345'
    required:
      - id
      - travelerType
  SearchCriteria:
    type: object
    properties:
      excludeAllotments:
        description: This option allows to exclude the isAllotment flag associated to a booking class in the search response when it exist.
        type: boolean
        example: false
      addOneWayOffers:
        description: This option allows activate the one-way combinable feature
        type: boolean
        example: true
      maxFlightOffers:
        description: Maximum number of flight offers returned (Max 250)
        type: number
        default: 250
        example: 250
      maxPrice:
        description: maximum price per traveler. By default, no limit is applied. If specified, the value should be a positive number with no decimals
        type: integer
        example: 100
      allowAlternativeFareOptions:
        description: This option allows to default to a standard fareOption if no offers are found for the selected fareOption.
        type: boolean
        example: true
      oneFlightOfferPerDay:
        description: Requests the system to find at least one flight-offer per day, if possible, when a range of dates is specified. Default is false.
        type: boolean
        example: true
      additionalInformation:
        title: AdditionalInformation
        type: object
        properties:
          chargeableCheckedBags:
            description: If true, returns the price of the first additional bag when the airline is an "Amadeus Ancillary Services" member.
            type: boolean
            example: true
          brandedFares:
            description: If true, returns the fare family name for each flight-offer which supports fare family
            type: boolean
            example: true
      pricingOptions:
        $ref: '#/definitions/Extended_PricingOptions'
      flightFilters:
        title: FlightFilters
        $ref: '#/definitions/FlightFilters'
  CabinRestriction:
    title: CabinRestriction
    type: object
    properties:
      cabin:
        $ref: '#/definitions/TravelClass'
      originDestinationIds:
        title: originDestinationIds
        description: The list of originDestination identifiers for which the cabinRestriction applies
        type: array
        items:
          type: string
        example:
          - 1
          - 2
  Extended_CabinRestriction:
    allOf:
      - $ref: '#/definitions/CabinRestriction'
      - type: object
        properties:
          coverage:
            $ref: '#/definitions/Coverage'
  FlightFilters:
    type: object
    properties:
      crossBorderAllowed:
        description: Allows to search a location outside the borders when a radius around a location is specified. Default is false.
        type: boolean
        example: false
      moreOvernightsAllowed:
        description: This flag enables/disables the possibility to have more overnight flights in Low Fare Search
        type: boolean
        example: false
      returnToDepartureAirport:
        description: This option force to retrieve flight-offer with a departure and a return in the same airport
        type: boolean
        example: false
      railSegmentAllowed:
        description: This flag enable/disable filtering of rail segment (TGV AIR, RAIL ...)
        type: boolean
        example: true
      busSegmentAllowed:
        description: This flag enable/disable filtering of bus segment
        type: boolean
        example: true
      maxFlightTime:
        description: Maximum flight time as a percentage relative to the shortest flight time available for the itinerary
        type: number
        example: 200
      carrierRestrictions:
        title: CarrierRestrictions
        description: Restriction towards carriers.
        $ref: '#/definitions/CarrierRestrictions'
      cabinRestrictions:
        title: CabinRestrictions
        description: Restriction towards cabins.
        type: array
        minItems: 1
        maxItems: 6
        items:
          $ref: '#/definitions/Extended_CabinRestriction'
      connectionRestriction:
        title: ConnectionRestriction
        description: Restriction towards number of connections.
        $ref: '#/definitions/ConnectionRestriction'
  CarrierRestrictions:
    description: Restriction towards carriers.
    type: object
    properties:
      blacklistedInEUAllowed:
        description: This flag enable/disable filtering of blacklisted airline by EU. The list of the banned airlines is published in the Official Journal of the European Union, where they are included as annexes A and B to the Commission Regulation. The blacklist of an airline can concern all its flights or some specific aircraft types pertaining to the airline
        type: boolean
        default: false
        example: true
      excludedCarrierCodes:
        description: This option ensures that the system will only consider these airlines.
        type: array
        minItems: 1
        maxItems: 99
        items:
          type: string
      includedCarrierCodes:
        description: This option ensures that the system will only consider these airlines.
        type: array
        minItems: 1
        maxItems: 99
        items:
          type: string
  ConnectionRestriction:
    description: Restriction towards number of connections.
    type: object
    properties:
      maxNumberOfConnections:
        description: The maximal number of connections for each itinerary. Value can be 0, 1 or 2.
        type: number
        example: 2
      nonStopPreferred:
        description: When this option is requested, recommendations made of Non-Stop flights only are favoured by the search, on the whole itinerary, with a weight of 75%.
        type: boolean
        example: false
      airportChangeAllowed:
        description: Allow to change airport during connection
        type: boolean
        example: false
      technicalStopsAllowed:
        description: This option allows the single segment to have one or more intermediate stops (technical stops).
        type: boolean
        example: true
  FlightOffer:
    title: Flight-offer
    type: object
    required:
      - type
      - id
    properties:
      type:
        type: string
        description: the resource name
        example: flight-offer
      id:
        description: Id of the flight offer
        type: string
        example: '1'
      source:
        $ref: '#/definitions/FlightOfferSource'
      instantTicketingRequired:
        description: If true, inform that a ticketing will be required at booking step.
        type: boolean
        example: false
      disablePricing:
        description: BOOK step ONLY - If true, allows to book a PNR without pricing. Only for the source "GDS"
        type: boolean
        example: false
      nonHomogeneous:
        description: If true, upon completion of the booking, this pricing solution is expected to yield multiple records (a record contains booking information confirmed and stored, typically a Passenger Name Record (PNR), in the provider GDS or system)
        type: boolean
        example: false
      oneWay:
        description: If true, the flight offer can be combined with other oneWays flight-offers to complete the whole journey (one-Way combinable feature).
        type: boolean
        example: false
      paymentCardRequired:
        description: If true, a payment card is mandatory to book this flight offer
        type: boolean
        example: false
      lastTicketingDate:
        description: If booked on the same day as the search (with respect to timezone), this flight offer is guaranteed to be thereafter valid for ticketing until this date (included). Unspecified when it does not make sense for this flight offer (e.g. no control over ticketing once booked). YYYY-MM-DD format, e.g. 2019-06-07
        type: string
        example: '2018-06-19'
      lastTicketingDateTime:
        description: If booked on the same day as the search (with respect to timezone), this flight offer is guaranteed to be thereafter valid for ticketing until this date/time (included). Unspecified when it does not make sense for this flight offer (e.g. no control over ticketing once booked). Information only this attribute is not used in input of pricing request. Local date and time in YYYY-MM-ddThh:mm:ss format, e.g. 2017-02-10T20:40:00
        type: string
        format: date-time
        example: '2018-06-19T15:00:00'
      numberOfBookableSeats:
        description: Number of seats bookable in a single request. Ca

# --- truncated at 32 KB (61 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/openapi/amadeus-flight-offers-search-openapi.yml