Ballerina library

amadeus.flightofferssearch

Module amadeus.flightofferssearch

OverviewPrerequisites

API

Client

Definitions

AdditionalInformation
AdditionalService
AdditionalServicesRequest
AircraftEntry
AircraftEquipment
AllotmentDetails
BaggageAllowance
CabinRestriction
CarrierEntry
CarrierRestrictions
ClientHttp1Settings
Co2Emission
CollectionLinksCollectionMeta
CollectionMetaLinkConnectionConfig
ConnectionRestriction
CurrencyEntry
DateTimeRange
Dictionaries
Error400
Error500
ExtendedPrice
ExtendedPricingOptions
FareDetailsBySegment
Fee
FlightEndPoint
FlightFilters
FlightOffer
FlightSegment
FlightStop
GetFlightOffersQuery
Issue
IssueSource
Itineraries
LocationEntry
LocationValue
OAuth2ClientCredentialsGrantConfig
OneWayCombinations
OperatingFlight
OriginalFlightEndPoint
OriginalFlightStop
OriginDestination
Price
PricingOptions
ProxyConfig
SearchCriteria
Segment
Success
Success1
Tax
Traveler
TravelerPricing

PricingOptionsFareType

TravelerType
TravelClass
ServiceName
FlightOfferSource
FeeType
Coverage
SliceDiceIndicator
AdditionalServiceType
TravelerPricingFareOption

ballerinax/amadeus.flightofferssearch Ballerina library

1.3.2

Overview

The Amadeus Flight Offers Search API connector(https://developers.amadeus.com/self-service/category/air/api-doc/flight-offers-search) OpenAPI specification.

This Amadeus Flight Offers Search API provides the capability to search for the cheapest flight for a given itinerary.

Key Features

  • Programmatic access to create and manage resources via REST API
  • Manage user accounts and profiles
  • Seamless integration with REST API endpoints

Prerequisites

Before using this connector in your Ballerina application, complete the following:

Clients

amadeus.flightofferssearch: Client

Isolated

This is a generated connector for Amadeus Flight Offers Search API OpenAPI specification. This Amadeus Flight Offers Search API provides the capability to search for the cheapest flight for a given itinerary.

Constructor

Gets invoked to initialize the connector. The connector initialization requires clientId and clientSecret. Please create Amadeus account and Obtain clientId and clientSecret following this guide

init (ConnectionConfig config, string serviceUrl)
  • config ConnectionConfig - The configurations to be used when initializing the connector
  • serviceUrl string "https://test.api.amadeus.com/v2" - URL of the target service

getFlightOffers

Isolated FunctionRemote Function
function getFlightOffers(string originLocationCode, string destinationLocationCode, string departureDate, int adults, string? returnDate, int? children, int? infants, string? travelClass, string? includedAirlineCodes, string? excludedAirlineCodes, boolean nonStop, string? currencyCode, int? maxPrice, int max) returns Success|error

Return list of Flight Offers based on searching criteria.

Parameters
  • originLocationCode string - city/airport IATA code from which the traveler will depart, e.g. BOS for Boston
  • destinationLocationCode string - city/airport IATA code to which the traveler is going, e.g. PAR for Paris
  • departureDate string - the date on which the traveler will depart from the origin to go to the destination. Dates are specified in the ISO 8601 YYYY-MM-DD format, e.g. 2017-12-25
  • adults int - the number of adult travelers (age 12 or older on date of departure).
  • returnDate string? (default ()) - 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 YYYY-MM-DD format, e.g. 2018-02-28
  • children int? (default ()) - 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
  • infants int? (default ()) - 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
  • travelClass string? (default ()) - 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
  • includedAirlineCodes string? (default ()) - 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 and are comma-separated, e.g. 6X,7X,8X
  • excludedAirlineCodes string? (default ()) - 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 and are comma-separated, e.g. 6X,7X,8X
  • nonStop boolean (default false) - if set to true, the search will find only flights going from the origin to the destination with no stop in between
  • currencyCode string? (default ()) - the preferred currency for the flight offers. Currency is specified in the ISO 4217 format, e.g. EUR for Euro
  • maxPrice int? (default ()) - maximum price per traveler. By default, no limit is applied. If specified, the value should be a positive number with no decimals
  • max int (default 250) - maximum number of flight offers to return. If specified, the value should be greater than or equal to 1
Return Type

searchFlightOffers

Isolated FunctionRemote Function
function searchFlightOffers(string xHttpMethodOverride, byte[] payload) returns Success1|error

Return list of Flight Offers based on posted searching criteria.

Parameters
  • xHttpMethodOverride string - the HTTP method to apply
  • payload byte[] - list of criteria to retrieve a list of flight offers
Return Type

Records

amadeus.flightofferssearch: AdditionalInformation

Fields
  • chargeableCheckedBags? boolean - If true, returns the price of the first additional bag when the airline is an "Amadeus Ancillary Services" member.
  • brandedFares? boolean - If true, returns the fare family name for each flight-offer which supports fare family

amadeus.flightofferssearch: AdditionalService

Fields

amadeus.flightofferssearch: AdditionalServicesRequest

Fields
  • chargeableSeatNumber? string - seat number

amadeus.flightofferssearch: AircraftEntry

Fields

amadeus.flightofferssearch: AircraftEquipment

information related to the aircraft

Fields
  • code? string - IATA aircraft code (http://www.flugzeuginfo.net/table_accodes_iata_en.php)

amadeus.flightofferssearch: AllotmentDetails

Fields

amadeus.flightofferssearch: BaggageAllowance

baggageAllowance

Fields
  • quantity? int - Total number of units
  • weight? int - Weight of the baggage allowance
  • weightUnit? string - Code to qualify unit as pounds or kilos

amadeus.flightofferssearch: CabinRestriction

Fields
  • cabin? TravelClass - quality of service offered in the cabin where the seat is located in this flight. Economy, premium economy, business or first class
  • coverage? Coverage - part of the trip covered by the travel class restriction (ALL_SEGMENTS if ommited)
  • originDestinationIds? string[] - The list of originDestination identifiers for which the cabinRestriction applies

amadeus.flightofferssearch: CarrierEntry

Fields

amadeus.flightofferssearch: CarrierRestrictions

Restriction towards carriers.

Fields
  • blacklistedInEUAllowed? boolean - 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
  • excludedCarrierCodes? string[] - This option ensures that the system will only consider these airlines.
  • includedCarrierCodes? string[] - This option ensures that the system will only consider these airlines.

amadeus.flightofferssearch: ClientHttp1Settings

Closed record

Provides settings related to HTTP/1.x protocol.

Fields
  • keepAlive KeepAlive(default http:KEEPALIVE_AUTO) - Specifies whether to reuse a connection for multiple requests
  • chunking Chunking(default http:CHUNKING_AUTO) - The chunking behaviour of the request

amadeus.flightofferssearch: Co2Emission

Fields
  • weight? int - Weight of Co2 emitted for the concerned segment
  • weightUnit? string - Code to qualify unit as pounds or kilos
  • cabin? TravelClass - quality of service offered in the cabin where the seat is located in this flight. Economy, premium economy, business or first class
Fields

amadeus.flightofferssearch: CollectionMeta

Fields
Fields

amadeus.flightofferssearch: ConnectionConfig

Closed record

Provides a set of configurations for controlling the behaviours when communicating with a remote HTTP endpoint.

Fields
  • httpVersion HttpVersion(default http:HTTP_2_0) - The HTTP version understood by the client
  • timeout decimal(default 60) - The maximum time to wait (in seconds) for a response before closing the connection
  • forwarded string(default "disable") - The choice of setting forwarded/x-forwarded header
  • cache? CacheConfig - HTTP caching related configurations
  • compression Compression(default http:COMPRESSION_AUTO) - Specifies the way of handling compression (accept-encoding) header
  • circuitBreaker? CircuitBreakerConfig - Configurations associated with the behaviour of the Circuit Breaker
  • retryConfig? RetryConfig - Configurations associated with retrying
  • validation boolean(default true) - Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default

amadeus.flightofferssearch: ConnectionRestriction

Restriction towards number of connections.

Fields
  • maxNumberOfConnections? decimal - The maximal number of connections for each itinerary. Value can be 0, 1 or 2.
  • airportChangeAllowed? boolean - Allow to change airport during connection
  • technicalStopsAllowed? boolean - This option allows the single segment to have one or more intermediate stops (technical stops).

amadeus.flightofferssearch: CurrencyEntry

Fields

amadeus.flightofferssearch: DateTimeRange

Fields
  • date string - Dates are specified in the ISO 8601 YYYY-MM-DD format, e.g. 2018-12-25
  • dateWindow? string - 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".
  • time? string - Local time. hh:mm:ss format, e.g 10:30:00
  • timeWindow? string - 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".

amadeus.flightofferssearch: Dictionaries

Fields

amadeus.flightofferssearch: Error400

Fields

amadeus.flightofferssearch: Error500

Fields

amadeus.flightofferssearch: ExtendedPrice

price information

Fields
  • margin? string - 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.
  • grandTotal? string - Total amount paid by the user (including fees and selected additional services).
  • billingCurrency? string - Currency of the payment. It may be different than the requested currency
  • Fields Included from *Price

amadeus.flightofferssearch: ExtendedPricingOptions

fare filter options

Fields
  • includedCheckedBagsOnly? boolean - If true, returns the flight-offers with included checked bags only
  • refundableFare? boolean - If true, returns the flight-offers with refundable fares only
  • noRestrictionFare? boolean - If true, returns the flight-offers with no restriction fares only
  • noPenaltyFare? boolean - If true, returns the flight-offers with no penalty fares only

amadeus.flightofferssearch: FareDetailsBySegment

Fare details of the segment

Fields
  • segmentId string - Id of the segment
  • cabin? TravelClass - quality of service offered in the cabin where the seat is located in this flight. Economy, premium economy, business or first class
  • fareBasis? string - Fare basis specifying the rules of a fare. Usually, though not always, is composed of the booking class code followed by a set of letters and digits representing other characteristics of the ticket, such as refundability, minimum stay requirements, discounts or special promotional elements.
  • brandedFare? string - The name of the Fare Family corresponding to the fares. Only for the GDS provider and if the airline has fare families filled
  • 'class? string - The code of the booking class, a.k.a. class of service or Reservations/Booking Designator (RBD)
  • isAllotment? boolean - True if the corresponding booking class is in an allotment
  • sliceDiceIndicator? SliceDiceIndicator - slice and Dice indicator, such as Local Availability, Sub OnD(Origin and Destination) 1 Availability and Sub OnD 2 Availability

amadeus.flightofferssearch: Fee

a fee

Fields

amadeus.flightofferssearch: FlightEndPoint

departure or arrival information

Fields
  • at? string - local date and time in ISO8601 YYYY-MM-ddThh:mm:ss format, e.g. 2017-02-10T20:40:00

amadeus.flightofferssearch: FlightFilters

Fields
  • crossBorderAllowed? boolean - Allows to search a location outside the borders when a radius around a location is specified. Default is false.
  • moreOvernightsAllowed? boolean - This flag enables/disables the possibility to have more overnight flights in Low Fare Search
  • returnToDepartureAirport? boolean - This option force to retrieve flight-offer with a departure and a return in the same airport
  • railSegmentAllowed? boolean - This flag enable/disable filtering of rail segment (TGV AIR, RAIL ...)
  • busSegmentAllowed? boolean - This flag enable/disable filtering of bus segment
  • maxFlightTime? decimal - Maximum flight time as a percentage relative to the shortest flight time available for the itinerary

amadeus.flightofferssearch: FlightOffer

Fields
  • 'type string - the resource name
  • id string - Id of the flight offer
  • instantTicketingRequired? boolean - If true, inform that a ticketing will be required at booking step.
  • disablePricing? boolean - BOOK step ONLY - If true, allows to book a PNR without pricing. Only for the source "GDS"
  • nonHomogeneous? boolean - 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)
  • oneWay? boolean - If true, the flight offer can be combined with other oneWays flight-offers to complete the whole journey (one-Way combinable feature).
  • paymentCardRequired? boolean - If true, a payment card is mandatory to book this flight offer
  • lastTicketingDate? string - 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
  • numberOfBookableSeats? decimal - Number of seats bookable in a single request. Can not be higher than 9.
  • validatingAirlineCodes? string[] - This option ensures that the system will only consider offers with these airlines as validating carrier.
  • travelerPricings? TravelerPricing[] - Fare information for each traveler/segment

amadeus.flightofferssearch: FlightSegment

defining a flight segment; including both operating and marketing details when applicable

Fields
  • carrierCode? string - providing the airline / carrier code
  • number? string - the flight number as assigned by the carrier
  • duration? string - stop duration in ISO8601 PnYnMnDTnHnMnS format, e.g. PT2H10M
  • stops? FlightStop[] - information regarding the different stops composing the flight segment. E.g. technical stop, change of gauge...

amadeus.flightofferssearch: FlightStop

details of stops for direct or change of gauge flights

Fields
  • arrivalAt? string - arrival at the stop in ISO8601 YYYY-MM-ddThh:mm:ss format, e.g. 2017-02-10T20:40:00
  • departureAt? string - departure from the stop in ISO8601 YYYY-MM-ddThh:mm:ss format, e.g. 2017-02-10T20:40:00

amadeus.flightofferssearch: GetFlightOffersQuery

Fields
  • currencyCode? string - The currency code, as defined in ISO 4217, to reflect the currency in which this amount is expressed.
  • originDestinations OriginDestination[] - Origins and Destinations must be properly ordered in time (chronological order in accordance with the timezone of each location) to describe the journey consistently. Dates and times must not be past nor more than 365 days in the future, according to provider settings.Number of Origins and Destinations must not exceed the limit defined in provider settings.
  • travelers Traveler[] - travelers in the trip. Maximum number of passengers older than 2 yo (CHILD, ADULT, YOUGHT): 9. Each adult can travel with one INFANT so maximum total number of passengers: 18
  • sources FlightOfferSource[] - Allows enable one or more sources. If present in the list, these sources will be called by the system.

amadeus.flightofferssearch: Issue

Fields
  • status? int - the HTTP status code applicable to this error
  • code? int - an application-specific error code
  • title? string - a short summary of the error
  • detail? string - explanation of the error
  • 'source? IssueSource - an object containing references to the source of the error

amadeus.flightofferssearch: IssueSource

an object containing references to the source of the error

Fields
  • pointer? string - a JSON Pointer [RFC6901] to the associated entity in the request document
  • 'parameter? string - a string indicating which URI query parameter caused the issue
  • example? string - a string indicating an example of the right value

amadeus.flightofferssearch: Itineraries

Fields
  • duration? string - duration in ISO8601 PnYnMnDTnHnMnS format, e.g. PT2H10M for a duration of 2h10m

amadeus.flightofferssearch: LocationEntry

Fields

amadeus.flightofferssearch: LocationValue

Fields
  • cityCode? string - City code associated to the airport
  • countryCode? string - Country code of the airport

amadeus.flightofferssearch: OAuth2ClientCredentialsGrantConfig

Closed record

OAuth2 Client Credentials Grant Configs

Fields
  • tokenUrl string(default "https://test.api.amadeus.com/v1/security/oauth2/token") - Token URL

amadeus.flightofferssearch: OneWayCombinations

Fields
  • originDestinationId? string -

amadeus.flightofferssearch: OperatingFlight

information about the operating flight

Fields
  • carrierCode? string - providing the airline / carrier code

amadeus.flightofferssearch: OriginalFlightEndPoint

departure or arrival information

Fields
  • terminal? string - terminal name / number

amadeus.flightofferssearch: OriginalFlightStop

details of stops for direct or change of gauge flights

Fields
  • duration? string - stop duration in ISO8601 PnYnMnDTnHnMnS format, e.g. PT2H10M

amadeus.flightofferssearch: OriginDestination

Fields
  • originLocationCode? string - Origin location, such as a city or an airport. Currently, only the locations defined in IATA are supported.
  • originRadius? decimal - 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".
  • alternativeOriginsCodes? string[] - Set of alternative origin location, such as a city or an airport. Currently, only the locations defined in IATA are supported.
  • destinationLocationCode? string - Destination location, such as a city or an airport. Currently, only the locations defined in IATA are supported.
  • destinationRadius? decimal - 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".
  • alternativeDestinationsCodes? string[] - Set of alternative destination location, such as a city or an airport. Currently, only the locations defined in IATA are supported.
  • includedConnectionPoints? string[] - 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
  • excludedConnectionPoints? string[] - 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

amadeus.flightofferssearch: Price

Fields
  • total? string - Total amount paid by the user
  • base? string - Amount without taxes
  • fees? Fee[] - List of applicable fees
  • taxes? Tax[] -
  • refundableTaxes? string - The amount of taxes which are refundable

amadeus.flightofferssearch: PricingOptions

Fields
  • includedCheckedBagsOnly? boolean - If true, returns the flight-offers with included checked bags only
  • refundableFare? boolean - If true, returns the flight-offers with refundable fares only
  • noRestrictionFare? boolean - If true, returns the flight-offers with no restriction fares only
  • noPenaltyFare? boolean - If true, returns the flight-offers with no penalty fares only

amadeus.flightofferssearch: ProxyConfig

Closed record

Proxy server configurations to be used with the HTTP client endpoint.

Fields
  • host string(default "") - Host name of the proxy server
  • port int(default 0) - Proxy server port
  • userName string(default "") - Proxy server username
  • password string(default "") - Proxy server password

amadeus.flightofferssearch: SearchCriteria

Fields
  • excludeAllotments? boolean - This option allows to exclude the isAllotment flag associated to a booking class in the search response when it exist.
  • addOneWayOffers? boolean - This option allows activate the one-way combinable feature
  • maxFlightOffers? decimal - Maximum number of flight offers returned (Max 250)
  • maxPrice? int - maximum price per traveler. By default, no limit is applied. If specified, the value should be a positive number with no decimals
  • allowAlternativeFareOptions? boolean - This option allows to default to a standard fareOption if no offers are found for the selected fareOption.
  • oneFlightOfferPerDay? boolean - Requests the system to find at least one flight-offer per day, if possible, when a range of dates is specified. Default is false.

amadeus.flightofferssearch: Segment

Fields
  • id? string - Id of the segment
  • numberOfStops? int - Number of stops planned on the segment for technical or operation purpose i.e. refueling
  • blacklistedInEU? boolean - When the flight has a marketing or/and operating airline that is identified as blacklisted by the European Commission. To improve travel safety, the European Commission regularly updates the list of the banned carriers from operating in Europe. It allows any Travel Agency located in the European Union to easily identify and hide any travel recommendation based on some unsafe airlines. 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

amadeus.flightofferssearch: Success

Fields

amadeus.flightofferssearch: Success1

Fields

amadeus.flightofferssearch: Tax

a tax

Fields

amadeus.flightofferssearch: Traveler

Fields
  • travelerType TravelerType - traveler type age restrictions : CHILD < 12y, HELD_INFANT < 2y, SEATED_INFANT < 2y, SENIOR >=60y
  • associatedAdultId? string - if type="HELD_INFANT", corresponds to the adult travelers's id who will share the seat

amadeus.flightofferssearch: TravelerPricing

Fields
  • travelerId string - Id of the traveler
  • fareOption TravelerPricingFareOption - option specifying a group of fares, which may be valid under certain conditons Can be used to specify special fare discount for a passenger
  • travelerType TravelerType - traveler type age restrictions : CHILD < 12y, HELD_INFANT < 2y, SEATED_INFANT < 2y, SENIOR >=60y
  • associatedAdultId? string - if type="HELD_INFANT", corresponds to the adult traveler's id who will share the seat

Array types

amadeus.flightofferssearch: PricingOptionsFareType

string[]

PricingOptionsFareType

type of fare of the flight-offer

String types

amadeus.flightofferssearch: TravelerType

string

TravelerType

traveler type age restrictions : CHILD < 12y, HELD_INFANT < 2y, SEATED_INFANT < 2y, SENIOR >=60y

amadeus.flightofferssearch: TravelClass

string

TravelClass

quality of service offered in the cabin where the seat is located in this flight. Economy, premium economy, business or first class

amadeus.flightofferssearch: ServiceName

string

ServiceName

type of service

amadeus.flightofferssearch: FlightOfferSource

string

FlightOfferSource

source of the flight offer

amadeus.flightofferssearch: FeeType

string

FeeType

type of fee

amadeus.flightofferssearch: Coverage

string

Coverage

part of the trip covered by the travel class restriction (ALL_SEGMENTS if ommited)

amadeus.flightofferssearch: SliceDiceIndicator

string

SliceDiceIndicator

slice and Dice indicator, such as Local Availability, Sub OnD(Origin and Destination) 1 Availability and Sub OnD 2 Availability

amadeus.flightofferssearch: AdditionalServiceType

string

AdditionalServiceType

additional service type

amadeus.flightofferssearch: TravelerPricingFareOption

string

TravelerPricingFareOption

option specifying a group of fares, which may be valid under certain conditons Can be used to specify special fare discount for a passenger

Import

import ballerinax/amadeus.flightofferssearch;Copy

Other versions

1.3.2

1.3.11.3.01.2.01.0.0
See more...

Metadata

Released date: 3 days ago

Version: 1.3.2

License: Apache-2.0

Compatibility

Platform: any

Ballerina version: 2201.8.0

GraalVM compatible: Yes

Pull count

Total: 121

Current verison: 0

Weekly downloads

Source repository

Keywords

Type/Connector

Vendor/Amadeus

Area/CRM & Sales

Sales & CRM/Scheduling & Booking

Cost/Freemium

Contributors

Dependencies

ballerina/url/2.4.0ballerina/constraint/1.5.0ballerina/http/2.10.24

Terms of service

Privacy policy

Cookie policy

Delete policy

© 2026 WSO2 LLC