{"openapi":"3.0.0","info":{"description":"\nBefore 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. \n\nPlease also be aware that our test environment is based on a subset of the production, to see what is included in test please refer to our **[data collection](https://github.com/amadeus4dev/data-collection)**.\n","title":"Flight Choice Prediction","version":"2.0.2","x-logo":{"url":"https://amadeus.com/images/en/technology/mobile-tablet/mobile-woman-office-city.jpg.transform/medium/img.jpg"},"x-origin":[{"format":"swagger","url":"https://raw.githubusercontent.com/amadeus4dev/amadeus-open-api-specification/main/spec/json/FlightChoicePrediction_v2_swagger_specification.json","version":"2.0"}],"x-providerName":"amadeus.com","x-release-note":{"2.0.0":["Initial Version"]},"x-serviceName":"amadeus-flight-choice-prediction","x-status":"validated","x-tags":["#ama-for-dev"]},"paths":{"/shopping/flight-offers/prediction":{"parameters":[{"$ref":"#/components/parameters/getOverride"}],"post":{"description":"","operationId":"getFlightChoicePredict","requestBody":{"content":{"application/vnd.amadeus+json":{"schema":{"$ref":"#/components/schemas/FlightOffersSearchReply"}},"application/json":{"schema":{"$ref":"#/components/schemas/FlightOffersSearchReply"}}},"required":true},"responses":{"200":{"$ref":"#/components/responses/200"},"400":{"$ref":"#/components/responses/400"},"500":{"$ref":"#/components/responses/500"}},"summary":"Predict the choice of flight offers.","tags":["flight-choice-prediction"]}}},"x-generatedAt":"2025-06-15T13:47:10.003Z","servers":[{"url":"https://test.api.amadeus.com/v2"}],"components":{"parameters":{"getOverride":{"description":"the HTTP method to apply","in":"header","name":"X-HTTP-Method-Override","required":true,"schema":{"type":"string","default":"GET"}}},"responses":{"200":{"description":"Flight Offers Search Reply with prediction","content":{"application/vnd.amadeus+json":{"schema":{"example":{"data":[{"choiceProbability":"0.42","id":"1","instantTicketingRequired":false,"itineraries":[{"duration":"PT18H30M","segments":[{"aircraft":{"code":"772"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"CDG","terminal":"2E"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"GIG","terminal":"2"},"id":"40","number":"2410","numberOfStops":0,"operating":{"carrierCode":"AF"}},{"aircraft":{"code":"73H"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"CDG","terminal":"2F"},"id":"41","number":"1234","numberOfStops":0,"operating":{"carrierCode":"KL"}},{"aircraft":{"code":"73J"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"MAD","terminal":"2"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"id":"42","number":"1705","numberOfStops":0,"operating":{"carrierCode":"KL"}}]},{"duration":"PT26H10M","segments":[{"aircraft":{"code":"73J"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"MAD","terminal":"2"},"id":"81","number":"1706","numberOfStops":0,"operating":{"carrierCode":"KL"}},{"aircraft":{"code":"772"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"GIG","terminal":"2"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"id":"82","number":"705","numberOfStops":0,"operating":{"carrierCode":"KL"}}]}],"lastTicketingDate":"2025-06-15T13:47:10.001Z","nonHomogeneous":false,"numberOfBookableSeats":9,"oneWay":false,"price":{"base":"8314.00","currency":"USD","fees":[{"amount":"0.00","type":"SUPPLIER"},{"amount":"0.00","type":"TICKETING"}],"total":"8514.04"},"pricingOptions":{"fareType":["PUBLISHED"],"includedCheckedBagsOnly":true},"source":"GDS","travelerPricings":[{"fareDetailsBySegment":[{"cabin":"BUSINESS","class":"C","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"40"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"41"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"42"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","includedCheckedBags":{"quantity":1},"segmentId":"81"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","includedCheckedBags":{"quantity":1},"segmentId":"82"}],"fareOption":"STANDARD","price":{"base":"4749.00","currency":"USD","total":"4849.02"},"travelerId":"1","travelerType":"ADULT"},{"fareDetailsBySegment":[{"cabin":"BUSINESS","class":"C","fareBasis":"CFFBR","segmentId":"40"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","segmentId":"41"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","segmentId":"42"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","segmentId":"81"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","segmentId":"82"}],"fareOption":"STANDARD","price":{"base":"3565.00","currency":"USD","total":"3665.02"},"travelerId":"2","travelerType":"CHILD"}],"type":"flight-offer","validatingAirlineCodes":["AF"]},{"choiceProbability":"0.11","id":"2","instantTicketingRequired":false,"itineraries":[{"duration":"PT19H35M","segments":[{"aircraft":{"code":"77W"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"CDG","terminal":"2E"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"GIG","terminal":"2"},"id":"43","number":"2412","numberOfStops":0,"operating":{"carrierCode":"AF"}},{"aircraft":{"code":"73W"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"CDG","terminal":"2F"},"id":"44","number":"1224","numberOfStops":0,"operating":{"carrierCode":"KL"}},{"aircraft":{"code":"73J"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"MAD","terminal":"2"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"id":"45","number":"1703","numberOfStops":0,"operating":{"carrierCode":"KL"}}]},{"duration":"PT26H10M","segments":[{"aircraft":{"code":"73J"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"MAD","terminal":"2"},"id":"81","number":"1706","numberOfStops":0,"operating":{"carrierCode":"KL"}},{"aircraft":{"code":"772"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"GIG","terminal":"2"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"id":"82","number":"705","numberOfStops":0,"operating":{"carrierCode":"KL"}}]}],"lastTicketingDate":"2025-06-15T13:47:10.001Z","nonHomogeneous":false,"numberOfBookableSeats":9,"oneWay":false,"price":{"base":"8314.00","currency":"USD","fees":[{"amount":"0.00","type":"SUPPLIER"},{"amount":"0.00","type":"TICKETING"}],"total":"8514.04"},"pricingOptions":{"fareType":["PUBLISHED"],"includedCheckedBagsOnly":true},"source":"GDS","travelerPricings":[{"fareDetailsBySegment":[{"cabin":"BUSINESS","class":"C","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"43"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"44"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"45"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","includedCheckedBags":{"quantity":1},"segmentId":"81"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","includedCheckedBags":{"quantity":1},"segmentId":"82"}],"fareOption":"STANDARD","price":{"base":"4749.00","currency":"USD","total":"4849.02"},"travelerId":"1","travelerType":"ADULT"},{"fareDetailsBySegment":[{"cabin":"BUSINESS","class":"C","fareBasis":"CFFBR","segmentId":"43"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","segmentId":"44"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","segmentId":"45"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","segmentId":"81"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","segmentId":"82"}],"fareOption":"STANDARD","price":{"base":"3565.00","currency":"USD","total":"3665.02"},"travelerId":"2","travelerType":"CHILD"}],"type":"flight-offer","validatingAirlineCodes":["AF"]},{"choiceProbability":"0.76","id":"3","instantTicketingRequired":false,"itineraries":[{"duration":"PT19H35M","segments":[{"aircraft":{"code":"77W"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"CDG","terminal":"2E"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"GIG","terminal":"2"},"id":"46","number":"2412","numberOfStops":0,"operating":{"carrierCode":"AF"}},{"aircraft":{"code":"73H"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"CDG","terminal":"2F"},"id":"47","number":"1228","numberOfStops":0,"operating":{"carrierCode":"KL"}},{"aircraft":{"code":"73J"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"MAD","terminal":"2"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"id":"48","number":"1703","numberOfStops":0,"operating":{"carrierCode":"KL"}}]},{"duration":"PT26H10M","segments":[{"aircraft":{"code":"73J"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"MAD","terminal":"2"},"id":"81","number":"1706","numberOfStops":0,"operating":{"carrierCode":"KL"}},{"aircraft":{"code":"772"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"GIG","terminal":"2"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"id":"82","number":"705","numberOfStops":0,"operating":{"carrierCode":"KL"}}]}],"lastTicketingDate":"2025-06-15T13:47:10.001Z","nonHomogeneous":false,"numberOfBookableSeats":9,"oneWay":false,"price":{"base":"8314.00","currency":"USD","fees":[{"amount":"0.00","type":"SUPPLIER"},{"amount":"0.00","type":"TICKETING"}],"total":"8514.04"},"pricingOptions":{"fareType":["PUBLISHED"],"includedCheckedBagsOnly":true},"source":"GDS","travelerPricings":[{"fareDetailsBySegment":[{"cabin":"BUSINESS","class":"C","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"46"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"47"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"48"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","includedCheckedBags":{"quantity":1},"segmentId":"81"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","includedCheckedBags":{"quantity":1},"segmentId":"82"}],"fareOption":"STANDARD","price":{"base":"4749.00","currency":"USD","total":"4849.02"},"travelerId":"1","travelerType":"ADULT"},{"fareDetailsBySegment":[{"cabin":"BUSINESS","class":"C","fareBasis":"CFFBR","segmentId":"46"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","segmentId":"47"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","segmentId":"48"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","segmentId":"81"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","segmentId":"82"}],"fareOption":"STANDARD","price":{"base":"3565.00","currency":"USD","total":"3665.02"},"travelerId":"2","travelerType":"CHILD"}],"type":"flight-offer","validatingAirlineCodes":["AF"]}],"meta":{"count":3}},"properties":{"data":{"items":{"$ref":"#/components/schemas/FlightOffer"},"type":"array"},"dictionaries":{"$ref":"#/components/schemas/Dictionaries"},"meta":{"$ref":"#/components/schemas/Collection_Meta"},"warnings":{"items":{"$ref":"#/components/schemas/Issue"},"type":"array"}},"required":["data"],"title":"Success"}},"application/json":{"schema":{"example":{"data":[{"choiceProbability":"0.42","id":"1","instantTicketingRequired":false,"itineraries":[{"duration":"PT18H30M","segments":[{"aircraft":{"code":"772"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"CDG","terminal":"2E"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"GIG","terminal":"2"},"id":"40","number":"2410","numberOfStops":0,"operating":{"carrierCode":"AF"}},{"aircraft":{"code":"73H"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"CDG","terminal":"2F"},"id":"41","number":"1234","numberOfStops":0,"operating":{"carrierCode":"KL"}},{"aircraft":{"code":"73J"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"MAD","terminal":"2"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"id":"42","number":"1705","numberOfStops":0,"operating":{"carrierCode":"KL"}}]},{"duration":"PT26H10M","segments":[{"aircraft":{"code":"73J"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"MAD","terminal":"2"},"id":"81","number":"1706","numberOfStops":0,"operating":{"carrierCode":"KL"}},{"aircraft":{"code":"772"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"GIG","terminal":"2"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"id":"82","number":"705","numberOfStops":0,"operating":{"carrierCode":"KL"}}]}],"lastTicketingDate":"2025-06-15T13:47:10.001Z","nonHomogeneous":false,"numberOfBookableSeats":9,"oneWay":false,"price":{"base":"8314.00","currency":"USD","fees":[{"amount":"0.00","type":"SUPPLIER"},{"amount":"0.00","type":"TICKETING"}],"total":"8514.04"},"pricingOptions":{"fareType":["PUBLISHED"],"includedCheckedBagsOnly":true},"source":"GDS","travelerPricings":[{"fareDetailsBySegment":[{"cabin":"BUSINESS","class":"C","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"40"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"41"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"42"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","includedCheckedBags":{"quantity":1},"segmentId":"81"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","includedCheckedBags":{"quantity":1},"segmentId":"82"}],"fareOption":"STANDARD","price":{"base":"4749.00","currency":"USD","total":"4849.02"},"travelerId":"1","travelerType":"ADULT"},{"fareDetailsBySegment":[{"cabin":"BUSINESS","class":"C","fareBasis":"CFFBR","segmentId":"40"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","segmentId":"41"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","segmentId":"42"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","segmentId":"81"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","segmentId":"82"}],"fareOption":"STANDARD","price":{"base":"3565.00","currency":"USD","total":"3665.02"},"travelerId":"2","travelerType":"CHILD"}],"type":"flight-offer","validatingAirlineCodes":["AF"]},{"choiceProbability":"0.11","id":"2","instantTicketingRequired":false,"itineraries":[{"duration":"PT19H35M","segments":[{"aircraft":{"code":"77W"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"CDG","terminal":"2E"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"GIG","terminal":"2"},"id":"43","number":"2412","numberOfStops":0,"operating":{"carrierCode":"AF"}},{"aircraft":{"code":"73W"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"CDG","terminal":"2F"},"id":"44","number":"1224","numberOfStops":0,"operating":{"carrierCode":"KL"}},{"aircraft":{"code":"73J"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"MAD","terminal":"2"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"id":"45","number":"1703","numberOfStops":0,"operating":{"carrierCode":"KL"}}]},{"duration":"PT26H10M","segments":[{"aircraft":{"code":"73J"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"MAD","terminal":"2"},"id":"81","number":"1706","numberOfStops":0,"operating":{"carrierCode":"KL"}},{"aircraft":{"code":"772"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"GIG","terminal":"2"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"id":"82","number":"705","numberOfStops":0,"operating":{"carrierCode":"KL"}}]}],"lastTicketingDate":"2025-06-15T13:47:10.001Z","nonHomogeneous":false,"numberOfBookableSeats":9,"oneWay":false,"price":{"base":"8314.00","currency":"USD","fees":[{"amount":"0.00","type":"SUPPLIER"},{"amount":"0.00","type":"TICKETING"}],"total":"8514.04"},"pricingOptions":{"fareType":["PUBLISHED"],"includedCheckedBagsOnly":true},"source":"GDS","travelerPricings":[{"fareDetailsBySegment":[{"cabin":"BUSINESS","class":"C","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"43"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"44"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"45"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","includedCheckedBags":{"quantity":1},"segmentId":"81"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","includedCheckedBags":{"quantity":1},"segmentId":"82"}],"fareOption":"STANDARD","price":{"base":"4749.00","currency":"USD","total":"4849.02"},"travelerId":"1","travelerType":"ADULT"},{"fareDetailsBySegment":[{"cabin":"BUSINESS","class":"C","fareBasis":"CFFBR","segmentId":"43"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","segmentId":"44"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","segmentId":"45"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","segmentId":"81"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","segmentId":"82"}],"fareOption":"STANDARD","price":{"base":"3565.00","currency":"USD","total":"3665.02"},"travelerId":"2","travelerType":"CHILD"}],"type":"flight-offer","validatingAirlineCodes":["AF"]},{"choiceProbability":"0.76","id":"3","instantTicketingRequired":false,"itineraries":[{"duration":"PT19H35M","segments":[{"aircraft":{"code":"77W"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"CDG","terminal":"2E"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"GIG","terminal":"2"},"id":"46","number":"2412","numberOfStops":0,"operating":{"carrierCode":"AF"}},{"aircraft":{"code":"73H"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"CDG","terminal":"2F"},"id":"47","number":"1228","numberOfStops":0,"operating":{"carrierCode":"KL"}},{"aircraft":{"code":"73J"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"MAD","terminal":"2"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"id":"48","number":"1703","numberOfStops":0,"operating":{"carrierCode":"KL"}}]},{"duration":"PT26H10M","segments":[{"aircraft":{"code":"73J"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"MAD","terminal":"2"},"id":"81","number":"1706","numberOfStops":0,"operating":{"carrierCode":"KL"}},{"aircraft":{"code":"772"},"arrival":{"at":"2025-06-15T13:47:10.001Z","iataCode":"GIG","terminal":"2"},"blacklistedInEU":false,"carrierCode":"KL","departure":{"at":"2025-06-15T13:47:10.001Z","iataCode":"AMS"},"id":"82","number":"705","numberOfStops":0,"operating":{"carrierCode":"KL"}}]}],"lastTicketingDate":"2025-06-15T13:47:10.001Z","nonHomogeneous":false,"numberOfBookableSeats":9,"oneWay":false,"price":{"base":"8314.00","currency":"USD","fees":[{"amount":"0.00","type":"SUPPLIER"},{"amount":"0.00","type":"TICKETING"}],"total":"8514.04"},"pricingOptions":{"fareType":["PUBLISHED"],"includedCheckedBagsOnly":true},"source":"GDS","travelerPricings":[{"fareDetailsBySegment":[{"cabin":"BUSINESS","class":"C","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"46"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"47"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","includedCheckedBags":{"quantity":2},"segmentId":"48"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","includedCheckedBags":{"quantity":1},"segmentId":"81"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","includedCheckedBags":{"quantity":1},"segmentId":"82"}],"fareOption":"STANDARD","price":{"base":"4749.00","currency":"USD","total":"4849.02"},"travelerId":"1","travelerType":"ADULT"},{"fareDetailsBySegment":[{"cabin":"BUSINESS","class":"C","fareBasis":"CFFBR","segmentId":"46"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","segmentId":"47"},{"cabin":"BUSINESS","class":"J","fareBasis":"CFFBR","segmentId":"48"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","segmentId":"81"},{"cabin":"ECONOMY","class":"Y","fareBasis":"YFFBR","segmentId":"82"}],"fareOption":"STANDARD","price":{"base":"3565.00","currency":"USD","total":"3665.02"},"travelerId":"2","travelerType":"CHILD"}],"type":"flight-offer","validatingAirlineCodes":["AF"]}],"meta":{"count":3}},"properties":{"data":{"items":{"$ref":"#/components/schemas/FlightOffer"},"type":"array"},"dictionaries":{"$ref":"#/components/schemas/Dictionaries"},"meta":{"$ref":"#/components/schemas/Collection_Meta"},"warnings":{"items":{"$ref":"#/components/schemas/Issue"},"type":"array"}},"required":["data"],"title":"Success"}}}},"400":{"description":"code    | title                                 \n------- | ------------------------------------- \n477     | INVALID FORMAT\n32171   | MANDATORY DATA MISSING\n","content":{"application/vnd.amadeus+json":{"schema":{"$ref":"#/components/schemas/Error_400"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error_400"}}}},"500":{"description":"Unexpected error","content":{"application/vnd.amadeus+json":{"schema":{"$ref":"#/components/schemas/Error_500"}},"application/json":{"schema":{"$ref":"#/components/schemas/Error_500"}}}}},"schemas":{"AdditionalServiceType":{"description":"additional service type","enum":["CHECKED_BAGS","MEALS","SEATS","OTHER_SERVICES"],"example":"CHECKED_BAGS","type":"string"},"AircraftEntry":{"additionalProperties":{"description":"the manufacturer/model of aircraft","type":"string"}},"AircraftEquipment":{"description":"information related to the aircraft","properties":{"code":{"description":"IATA aircraft code (http://www.flugzeuginfo.net/table_accodes_iata_en.php)\n","example":"318","pattern":"[a-zA-Z0-9]{3}","type":"string"},"configurationVersion":{"description":"aircraft Configuration Version code. Physical configuration, also called ACV code (aircraft type + fitted configuration)\n","example":"2C1","pattern":"[A-Z0-9]{3}","type":"string"}}},"BaggageAllowance":{"description":"baggageAllowance","properties":{"quantity":{"description":"Total number of units","example":1,"type":"integer"},"weight":{"description":"Weight of the baggage allowance","example":20,"type":"integer"},"weightUnit":{"description":"Code to qualify unit as pounds or kilos","example":"KG","type":"string"}},"type":"object"},"CarrierEntry":{"additionalProperties":{"description":"the carrier name","type":"string"}},"Co2Emission":{"properties":{"cabin":{"$ref":"#/components/schemas/TravelClass"},"weight":{"description":"Weight of Co2 emitted for the concerned segment","example":90,"type":"integer"},"weightUnit":{"description":"Code to qualify unit as pounds or kilos","example":"KG","type":"string"}},"type":"object"},"CollectionLinks":{"example":{"self":"https://test.api.amadeus.com/v1/area/resources?param=value"},"properties":{"first":{"example":"https://test.api.amadeus.com/v1/area/resources?...","format":"uri","type":"string"},"last":{"example":"https://test.api.amadeus.com/v1/area/resources?...","format":"uri","type":"string"},"next":{"example":"https://test.api.amadeus.com/v1/area/resources?...","format":"uri","type":"string"},"previous":{"example":"https://test.api.amadeus.com/v1/area/resources?...","format":"uri","type":"string"},"self":{"example":"https://test.api.amadeus.com/v1/area/resources?...","format":"uri","type":"string"},"up":{"example":"https://test.api.amadeus.com/v1/area/resources?...","format":"uri","type":"string"}},"title":"CollectionLinks"},"Collection_Meta":{"description":"meta information","properties":{"count":{"example":1,"type":"integer"},"links":{"$ref":"#/components/schemas/CollectionLinks"},"oneWayCombinations":{"items":{"properties":{"flightOfferIds":{"items":{"type":"string"},"type":"array"},"originDestinationId":{"type":"string"}},"title":"oneWayCombinations"},"type":"array"}},"title":"Collection_Meta","type":"object"},"CurrencyEntry":{"additionalProperties":{"example":"EUR","type":"string"}},"Dictionaries":{"properties":{"aircraft":{"$ref":"#/components/schemas/AircraftEntry"},"carriers":{"$ref":"#/components/schemas/CarrierEntry"},"currencies":{"$ref":"#/components/schemas/CurrencyEntry"},"locations":{"$ref":"#/components/schemas/LocationEntry"}},"type":"object"},"Error_400":{"example":{"errors":[{"code":477,"detail":"invalid query parameter format","source":{"example":"CDG","parameter":"airport"},"status":400,"title":"INVALID FORMAT"}]},"properties":{"errors":{"items":{"$ref":"#/components/schemas/Issue"},"type":"array"}},"required":["errors"]},"Error_500":{"example":{"errors":[{"code":141,"status":500,"title":"SYSTEM ERROR HAS OCCURRED"}]},"properties":{"errors":{"items":{"$ref":"#/components/schemas/Issue"},"type":"array"}},"required":["errors"]},"Extended_Price":{"allOf":[{"properties":{"additionalServices":{"items":{"properties":{"amount":{"example":"332.70","type":"string"},"type":{"$ref":"#/components/schemas/AdditionalServiceType"}},"title":"AdditionalService","type":"object"},"title":"AdditionalServices","type":"array"},"billingCurrency":{"description":"Currency of the payment. It may be different than the requested currency","example":"EUR","type":"string"},"grandTotal":{"description":"Total amount paid by the user (including fees and selected additional services).","example":"987.00","type":"string"},"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.","example":"1.00","type":"string"}},"type":"object"},{"$ref":"#/components/schemas/Price"}],"description":"price information","title":"Price","type":"object"},"FareRules":{"properties":{"currency":{"description":"The currency of the penalties","type":"string"},"rules":{"items":{"$ref":"#/components/schemas/TermAndCondition"},"minItems":1,"type":"array"}},"title":"FareRules","type":"object"},"Fee":{"description":"a fee","properties":{"amount":{"example":"332.70","type":"string"},"type":{"$ref":"#/components/schemas/FeeType"}}},"FeeType":{"description":"type of fee","enum":["TICKETING","FORM_OF_PAYMENT","SUPPLIER"],"example":"TICKETING","type":"string"},"FlightEndPoint":{"allOf":[{"$ref":"#/components/schemas/OriginalFlightEndPoint"},{"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","example":"2025-06-15T13:47:10.002Z","format":"date-time","type":"string"}},"type":"object"}],"description":"departure or arrival information","title":"FlightEndPoint"},"FlightOffer":{"properties":{"choiceProbability":{"description":"the choice probability of this Flight Offer. The value is between 1 (100% chance the FlightOffer will be selected) and 0 (no change the FlightOffer will be selected)","example":"0.42","type":"string"},"disablePricing":{"description":"BOOK step ONLY - If true, allows to book a PNR without pricing. Only for the source \"GDS\"","example":false,"type":"boolean"},"fareRules":{"$ref":"#/components/schemas/FareRules"},"id":{"description":"Id of the flight offer","example":"1","type":"string"},"instantTicketingRequired":{"description":"If true, inform that a ticketing will be required at booking step.","example":false,"type":"boolean"},"itineraries":{"items":{"properties":{"duration":{"description":"duration in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) PnYnMnDTnHnMnS format, e.g. PT2H10M for a duration of 2h10m","example":"PT2H10M","type":"string"},"segments":{"items":{"$ref":"#/components/schemas/Segment"},"maxItems":9,"minItems":1,"title":"Segments","type":"array"}},"required":["segments"],"title":"Itineraries","type":"object"},"maxItems":250,"minItems":1,"type":"array"},"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","example":"2025-06-15T13:47:10.002Z","type":"string"},"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)","example":false,"type":"boolean"},"numberOfBookableSeats":{"description":"Number of seats bookable in a single request. Can not be higher than 9.","example":9,"maximum":9,"minimum":1,"type":"number"},"oneWay":{"description":"If true, the flight offer fulfills only one originDestination and has to be combined with other oneWays to complete the whole journey.","example":false,"type":"boolean"},"paymentCardRequired":{"description":"If true, a payment card is mandatory to book this flight offer","example":false,"type":"boolean"},"price":{"$ref":"#/components/schemas/Extended_Price"},"pricingOptions":{"properties":{"corporateCodes":{"description":"Allow Corporate negotiated fares using one or more corporate number (corporate code).","example":["123456"],"items":{"type":"string"},"type":"array"},"fareType":{"$ref":"#/components/schemas/PricingOptionsFareType"},"includedCheckedBagsOnly":{"description":"If true, returns the flight-offers with included checked bags only","example":true,"type":"boolean"},"noPenaltyFare":{"description":"If true, returns the flight-offers with no penalty fares only","example":true,"type":"boolean"},"noRestrictionFare":{"description":"If true, returns the flight-offers with no restriction fares only","example":true,"type":"boolean"},"refundableFare":{"description":"If true, returns the flight-offers with refundable fares only","example":true,"type":"boolean"}},"title":"PricingOptions","type":"object"},"source":{"$ref":"#/components/schemas/FlightOfferSource"},"travelerPricings":{"description":"Fare information for each traveler/segment","items":{"properties":{"associatedAdultId":{"description":"if type=\"HELD_INFANT\", corresponds to the adult traveler's id who will share the seat","type":"string"},"fareDetailsBySegment":{"items":{"description":"Fare details of the segment","properties":{"additionalServices":{"properties":{"chargeableCheckedBags":{"$ref":"#/components/schemas/BaggageAllowance"},"chargeableSeatNumber":{"description":"seat number","example":"33D","pattern":"[1-9][0-9]{0,2}[A-Z]?","type":"string"},"otherServices":{"description":"Other services to add","example":["PRIORITY_BOARDING"],"items":{"$ref":"#/components/schemas/ServiceName"},"type":"array"}},"title":"AdditionalServicesRequest","type":"object"},"allotmentDetails":{"properties":{"tourName":{"type":"string"},"tourReference":{"type":"string"}},"title":"AllotmentDetails","type":"object"},"brandedFare":{"description":"The name of the Fare Family corresponding to the fares. Only for the GDS provider and if the airline has fare families filled","example":"LIGHTONE","type":"string"},"cabin":{"$ref":"#/components/schemas/TravelClass"},"class":{"description":"The code of the booking class, a.k.a. class of service or Reservations/Booking Designator (RBD)","example":"A","pattern":"[A-Z]{1}","type":"string"},"fareBasis":{"description":"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.","example":"ANNNNF4K","pattern":"[[A-Z0-9]{1,18}","type":"string"},"includedCheckedBags":{"$ref":"#/components/schemas/BaggageAllowance"},"isAllotment":{"description":"True if the corresponding booking class is in an allotment","example":true,"type":"boolean"},"segmentId":{"description":"Id of the segment","example":"1","type":"string"},"sliceDiceIndicator":{"$ref":"#/components/schemas/SliceDiceIndicator"}},"required":["segmentId"],"title":"FareDetailsBySegment"},"maxItems":18,"minItems":1,"type":"array"},"fareOption":{"$ref":"#/components/schemas/TravelerPricingFareOption"},"price":{"$ref":"#/components/schemas/Price"},"travelerId":{"description":"Id of the traveler","example":"1","type":"string"},"travelerType":{"$ref":"#/components/schemas/TravelerType"}},"required":["travelerId","fareOption","travelerType","fareDetailsBySegment"],"title":"TravelerPricing"},"maxItems":18,"minItems":1,"title":"TravelerPricings","type":"array"},"type":{"description":"the resource name","example":"flight-offer","type":"string"},"validatingAirlineCodes":{"description":"This option ensures that the system will only consider these airlines.","example":["AF"],"items":{"type":"string"},"maxItems":9,"minItems":1,"type":"array"}},"required":["type","id","source"],"title":"Flight-offer","type":"object"},"FlightOfferSource":{"description":"source of the flight offer","enum":["GDS","PYTON"],"example":"GDS","type":"string"},"FlightOffersSearchReply":{"example":{"data":[{"id":"1","instantTicketingRequired":false,"itineraries":[{"duration":"PT15H55M","segments":[{"aircraft":{"code":"788"},"arrival":{"at":"2025-06-15T13:47:10.002Z","iataCode":"LHR","terminal":"5"},"blacklistedInEU":false,"carrierCode":"BA","departure":{"at":"2025-06-15T13:47:10.002Z","iataCode":"GIG","terminal":"2"},"duration":"PT11H20M","id":"1","number":"248","numberOfStops":0,"operating":{"carrierCode":"BA"}},{"aircraft":{"code":"321"},"arrival":{"at":"2025-06-15T13:47:10.002Z","iataCode":"MAD","terminal":"4S"},"blacklistedInEU":false,"carrierCode":"BA","departure":{"at":"2025-06-15T13:47:10.002Z","iataCode":"LHR","terminal":"5"},"duration":"PT2H30M","id":"2","number":"462","numberOfStops":0,"operating":{"carrierCode":"BA"}}]},{"duration":"PT13H35M","segments":[{"aircraft":{"code":"346"},"arrival":{"at":"2025-06-15T13:47:10.002Z","iataCode":"GRU","terminal":"3"},"blacklistedInEU":false,"carrierCode":"IB","departure":{"at":"2025-06-15T13:47:10.002Z","iataCode":"MAD","terminal":"4S"},"duration":"PT10H45M","id":"5","number":"6827","numberOfStops":0,"operating":{"carrierCode":"IB"}},{"aircraft":{"code":"320"},"arrival":{"at":"2025-06-15T13:47:10.002Z","iataCode":"GIG","terminal":"2"},"blacklistedInEU":false,"carrierCode":"LA","departure":{"at":"2025-06-15T13:47:10.002Z","iataCode":"GRU","terminal":"2"},"duration":"PT1H","id":"6","number":"4508","numberOfStops":0}]}],"lastTicketingDate":"2025-06-15T13:47:10.002Z","nonHomogeneous":false,"numberOfBookableSeats":7,"oneWay":false,"price":{"base":"3661.00","currency":"USD","fees":[{"amount":"0.00","type":"SUPPLIER"},{"amount":"0.00","type":"TICKETING"}],"grandTotal":"3842.10","total":"3842.10"},"pricingOptions":{"fareType":["PUBLISHED"],"includedCheckedBagsOnly":false},"source":"GDS","travelerPricings":[{"fareDetailsBySegment":[{"brandedFare":"BUSINESS","cabin":"BUSINESS","class":"R","fareBasis":"RNNZ60S3","includedCheckedBags":{"quantity":2},"segmentId":"1"},{"brandedFare":"BUSINESS","cabin":"BUSINESS","class":"J","fareBasis":"RNNZ60S3","includedCheckedBags":{"quantity":2},"segmentId":"2"},{"brandedFare":"BAGSEAT","cabin":"ECONOMY","class":"V","fareBasis":"VDH0NNM3","includedCheckedBags":{"quantity":1},"segmentId":"5"},{"brandedFare":"BAGSEAT","cabin":"ECONOMY","class":"V","fareBasis":"VDH0NNM3","includedCheckedBags":{"quantity":1},"segmentId":"6"}],"fareOption":"STANDARD","price":{"base":"2088.00","currency":"USD","total":"2178.55"},"travelerId":"1","travelerType":"ADULT"},{"fareDetailsBySegment":[{"brandedFare":"BUSINESS","cabin":"BUSINESS","class":"R","fareBasis":"RNNZ60S3","segmentId":"1"},{"brandedFare":"BUSINESS","cabin":"BUSINESS","class":"J","fareBasis":"RNNZ60S3","segmentId":"2"},{"brandedFare":"BAGSEAT","cabin":"ECONOMY","class":"V","fareBasis":"VDH0NNM3","segmentId":"5"},{"brandedFare":"BAGSEAT","cabin":"ECONOMY","class":"V","fareBasis":"VDH0NNM3","segmentId":"6"}],"fareOption":"STANDARD","price":{"base":"1573.00","currency":"USD","total":"1663.55"},"travelerId":"2","travelerType":"CHILD"}],"type":"flight-offer","validatingAirlineCodes":["BA"]},{"id":"2","instantTicketingRequired":false,"itineraries":[{"duration":"PT15H55M","segments":[{"aircraft":{"code":"788"},"arrival":{"at":"2025-06-15T13:47:10.002Z","iataCode":"LHR","terminal":"5"},"blacklistedInEU":false,"carrierCode":"BA","departure":{"at":"2025-06-15T13:47:10.002Z","iataCode":"GIG","terminal":"2"},"duration":"PT11H20M","id":"1","number":"248","numberOfStops":0,"operating":{"carrierCode":"BA"}},{"aircraft":{"code":"321"},"arrival":{"at":"2025-06-15T13:47:10.002Z","iataCode":"MAD","terminal":"4S"},"blacklistedInEU":false,"carrierCode":"BA","departure":{"at":"2025-06-15T13:47:10.002Z","iataCode":"LHR","terminal":"5"},"duration":"PT2H30M","id":"2","number":"462","numberOfStops":0,"operating":{"carrierCode":"BA"}}]},{"duration":"PT19H5M","segments":[{"aircraft":{"code":"346"},"arrival":{"at":"2025-06-15T13:47:10.002Z","iataCode":"GRU","terminal":"3"},"blacklistedInEU":false,"carrierCode":"IB","departure":{"at":"2025-06-15T13:47:10.002Z","iataCode":"MAD","terminal":"4S"},"duration":"PT10H45M","id":"3","number":"6827","numberOfStops":0,"operating":{"carrierCode":"IB"}},{"aircraft":{"code":"321"},"arrival":{"at":"2025-06-15T13:47:10.002Z","iataCode":"GIG","terminal":"2"},"blacklistedInEU":false,"carrierCode":"LA","departure":{"at":"2025-06-15T13:47:10.002Z","iataCode":"GRU","terminal":"2"},"duration":"PT1H","id":"4","number":"4537","numberOfStops":0}]}],"lastTicketingDate":"2025-06-15T13:47:10.002Z","nonHomogeneous":false,"numberOfBookableSeats":7,"oneWay":false,"price":{"base":"3661.00","currency":"USD","fees":[{"amount":"0.00","type":"SUPPLIER"},{"amount":"0.00","type":"TICKETING"}],"grandTotal":"3842.10","total":"3842.10"},"pricingOptions":{"fareType":["PUBLISHED"],"includedCheckedBagsOnly":false},"source":"GDS","travelerPricings":[{"fareDetailsBySegment":[{"brandedFare":"BUSINESS","cabin":"BUSINESS","class":"R","fareBasis":"RNNZ60S3","includedCheckedBags":{"quantity":2},"segmentId":"1"},{"brandedFare":"BUSINESS","cabin":"BUSINESS","class":"J","fareBasis":"RNNZ60S3","includedCheckedBags":{"quantity":2},"segmentId":"2"},{"brandedFare":"BAGSEAT","cabin":"ECONOMY","class":"V","fareBasis":"VDH0NNM3","includedCheckedBags":{"quantity":1},"segmentId":"3"},{"brandedFare":"BAGSEAT","cabin":"ECONOMY","class":"V","fareBasis":"VDH0NNM3","includedCheckedBags":{"quantity":1},"segmentId":"4"}],"fareOption":"STANDARD","price":{"base":"2088.00","currency":"USD","total":"2178.55"},"travelerId":"1","travelerType":"ADULT"},{"fareDetailsBySegment":[{"brandedFare":"BUSINESS","cabin":"BUSINESS","class":"R","fareBasis":"RNNZ60S3","segmentId":"1"},{"brandedFare":"BUSINESS","cabin":"BUSINESS","class":"J","fareBasis":"RNNZ60S3","segmentId":"2"},{"brandedFare":"BAGSEAT","cabin":"ECONOMY","class":"V","fareBasis":"VDH0NNM3","segmentId":"3"},{"brandedFare":"BAGSEAT","cabin":"ECONOMY","class":"V","fareBasis":"VDH0NNM3","segmentId":"4"}],"fareOption":"STANDARD","price":{"base":"1573.00","currency":"USD","total":"1663.55"},"travelerId":"2","travelerType":"CHILD"}],"type":"flight-offer","validatingAirlineCodes":["BA"]}],"dictionaries":{"aircraft":{"320":"AIRBUS INDUSTRIE A320-100/200","321":"AIRBUS INDUSTRIE A321","346":"AIRBUS INDUSTRIE A340-600","788":"BOEING 787-8"},"carriers":{"BA":"BRITISH AIRWAYS","IB":"IBERIA","LA":"LATAM AIRLINES GROUP"},"currencies":{"USD":"US DOLLAR"},"locations":{"GIG":{"cityCode":"RIO","countryCode":"BR"},"GRU":{"cityCode":"SAO","countryCode":"BR"},"LHR":{"cityCode":"LON","countryCode":"GB"},"MAD":{"cityCode":"MAD","countryCode":"ES"}}},"meta":{"count":2}},"properties":{"data":{"items":{"$ref":"#/components/schemas/FlightOffer"},"type":"array"},"dictionaries":{"$ref":"#/components/schemas/Dictionaries"},"meta":{"$ref":"#/components/schemas/Collection_Meta"},"warnings":{"items":{"$ref":"#/components/schemas/Issue"},"type":"array"}},"required":["data"],"title":"FlightOffersSearchReply","x-example":{"data":[{"id":"1","instantTicketingRequired":false,"itineraries":[{"duration":"PT15H55M","segments":[{"aircraft":{"code":"788"},"arrival":{"at":"2025-06-15T13:47:10.002Z","iataCode":"LHR","terminal":"5"},"blacklistedInEU":false,"carrierCode":"BA","departure":{"at":"2025-06-15T13:47:10.002Z","iataCode":"GIG","terminal":"2"},"duration":"PT11H20M","id":"1","number":"248","numberOfStops":0,"operating":{"carrierCode":"BA"}},{"aircraft":{"code":"321"},"arrival":{"at":"2025-06-15T13:47:10.002Z","iataCode":"MAD","terminal":"4S"},"blacklistedInEU":false,"carrierCode":"BA","departure":{"at":"2025-06-15T13:47:10.002Z","iataCode":"LHR","terminal":"5"},"duration":"PT2H30M","id":"2","number":"462","numberOfStops":0,"operating":{"carrierCode":"BA"}}]},{"duration":"PT13H35M","segments":[{"aircraft":{"code":"346"},"arrival":{"at":"2025-06-15T13:47:10.002Z","iataCode":"GRU","terminal":"3"},"blacklistedInEU":false,"carrierCode":"IB","departure":{"at":"2025-06-15T13:47:10.002Z","iataCode":"MAD","terminal":"4S"},"duration":"PT10H45M","id":"5","number":"6827","numberOfStops":0,"operating":{"carrierCode":"IB"}},{"aircraft":{"code":"320"},"arrival":{"at":"2025-06-15T13:47:10.002Z","iataCode":"GIG","terminal":"2"},"blacklistedInEU":false,"carrierCode":"LA","departure":{"at":"2025-06-15T13:47:10.002Z","iataCode":"GRU","terminal":"2"},"duration":"PT1H","id":"6","number":"4508","numberOfStops":0}]}],"lastTicketingDate":"2025-06-15T13:47:10.002Z","nonHomogeneous":false,"numberOfBookableSeats":7,"oneWay":false,"price":{"base":"3661.00","currency":"USD","fees":[{"amount":"0.00","type":"SUPPLIER"},{"amount":"0.00","type":"TICKETING"}],"grandTotal":"3842.10","total":"3842.10"},"pricingOptions":{"fareType":["PUBLISHED"],"includedCheckedBagsOnly":false},"source":"GDS","travelerPricings":[{"fareDetailsBySegment":[{"brandedFare":"BUSINESS","cabin":"BUSINESS","class":"R","fareBasis":"RNNZ60S3","includedCheckedBags":{"quantity":2},"segmentId":"1"},{"brandedFare":"BUSINESS","cabin":"BUSINESS","class":"J","fareBasis":"RNNZ60S3","includedCheckedBags":{"quantity":2},"segmentId":"2"},{"brandedFare":"BAGSEAT","cabin":"ECONOMY","class":"V","fareBasis":"VDH0NNM3","includedCheckedBags":{"quantity":1},"segmentId":"5"},{"brandedFare":"BAGSEAT","cabin":"ECONOMY","class":"V","fareBasis":"VDH0NNM3","includedCheckedBags":{"quantity":1},"segmentId":"6"}],"fareOption":"STANDARD","price":{"base":"2088.00","currency":"USD","total":"2178.55"},"travelerId":"1","travelerType":"ADULT"},{"fareDetailsBySegment":[{"brandedFare":"BUSINESS","cabin":"BUSINESS","class":"R","fareBasis":"RNNZ60S3","segmentId":"1"},{"brandedFare":"BUSINESS","cabin":"BUSINESS","class":"J","fareBasis":"RNNZ60S3","segmentId":"2"},{"brandedFare":"BAGSEAT","cabin":"ECONOMY","class":"V","fareBasis":"VDH0NNM3","segmentId":"5"},{"brandedFare":"BAGSEAT","cabin":"ECONOMY","class":"V","fareBasis":"VDH0NNM3","segmentId":"6"}],"fareOption":"STANDARD","price":{"base":"1573.00","currency":"USD","total":"1663.55"},"travelerId":"2","travelerType":"CHILD"}],"type":"flight-offer","validatingAirlineCodes":["BA"]},{"id":"2","instantTicketingRequired":false,"itineraries":[{"duration":"PT15H55M","segments":[{"aircraft":{"code":"788"},"arrival":{"at":"2025-06-15T13:47:10.002Z","iataCode":"LHR","terminal":"5"},"blacklistedInEU":false,"carrierCode":"BA","departure":{"at":"2025-06-15T13:47:10.002Z","iataCode":"GIG","terminal":"2"},"duration":"PT11H20M","id":"1","number":"248","numberOfStops":0,"operating":{"carrierCode":"BA"}},{"aircraft":{"code":"321"},"arrival":{"at":"2025-06-15T13:47:10.002Z","iataCode":"MAD","terminal":"4S"},"blacklistedInEU":false,"carrierCode":"BA","departure":{"at":"2025-06-15T13:47:10.002Z","iataCode":"LHR","terminal":"5"},"duration":"PT2H30M","id":"2","number":"462","numberOfStops":0,"operating":{"carrierCode":"BA"}}]},{"duration":"PT19H5M","segments":[{"aircraft":{"code":"346"},"arrival":{"at":"2025-06-15T13:47:10.002Z","iataCode":"GRU","terminal":"3"},"blacklistedInEU":false,"carrierCode":"IB","departure":{"at":"2025-06-15T13:47:10.002Z","iataCode":"MAD","terminal":"4S"},"duration":"PT10H45M","id":"3","number":"6827","numberOfStops":0,"operating":{"carrierCode":"IB"}},{"aircraft":{"code":"321"},"arrival":{"at":"2025-06-15T13:47:10.002Z","iataCode":"GIG","terminal":"2"},"blacklistedInEU":false,"carrierCode":"LA","departure":{"at":"2025-06-15T13:47:10.002Z","iataCode":"GRU","terminal":"2"},"duration":"PT1H","id":"4","number":"4537","numberOfStops":0}]}],"lastTicketingDate":"2025-06-15T13:47:10.002Z","nonHomogeneous":false,"numberOfBookableSeats":7,"oneWay":false,"price":{"base":"3661.00","currency":"USD","fees":[{"amount":"0.00","type":"SUPPLIER"},{"amount":"0.00","type":"TICKETING"}],"grandTotal":"3842.10","total":"3842.10"},"pricingOptions":{"fareType":["PUBLISHED"],"includedCheckedBagsOnly":false},"source":"GDS","travelerPricings":[{"fareDetailsBySegment":[{"brandedFare":"BUSINESS","cabin":"BUSINESS","class":"R","fareBasis":"RNNZ60S3","includedCheckedBags":{"quantity":2},"segmentId":"1"},{"brandedFare":"BUSINESS","cabin":"BUSINESS","class":"J","fareBasis":"RNNZ60S3","includedCheckedBags":{"quantity":2},"segmentId":"2"},{"brandedFare":"BAGSEAT","cabin":"ECONOMY","class":"V","fareBasis":"VDH0NNM3","includedCheckedBags":{"quantity":1},"segmentId":"3"},{"brandedFare":"BAGSEAT","cabin":"ECONOMY","class":"V","fareBasis":"VDH0NNM3","includedCheckedBags":{"quantity":1},"segmentId":"4"}],"fareOption":"STANDARD","price":{"base":"2088.00","currency":"USD","total":"2178.55"},"travelerId":"1","travelerType":"ADULT"},{"fareDetailsBySegment":[{"brandedFare":"BUSINESS","cabin":"BUSINESS","class":"R","fareBasis":"RNNZ60S3","segmentId":"1"},{"brandedFare":"BUSINESS","cabin":"BUSINESS","class":"J","fareBasis":"RNNZ60S3","segmentId":"2"},{"brandedFare":"BAGSEAT","cabin":"ECONOMY","class":"V","fareBasis":"VDH0NNM3","segmentId":"3"},{"brandedFare":"BAGSEAT","cabin":"ECONOMY","class":"V","fareBasis":"VDH0NNM3","segmentId":"4"}],"fareOption":"STANDARD","price":{"base":"1573.00","currency":"USD","total":"1663.55"},"travelerId":"2","travelerType":"CHILD"}],"type":"flight-offer","validatingAirlineCodes":["BA"]}],"dictionaries":{"aircraft":{"320":"AIRBUS INDUSTRIE A320-100/200","321":"AIRBUS INDUSTRIE A321","346":"AIRBUS INDUSTRIE A340-600","788":"BOEING 787-8"},"carriers":{"BA":"BRITISH AIRWAYS","IB":"IBERIA","LA":"LATAM AIRLINES GROUP"},"currencies":{"USD":"US DOLLAR"},"locations":{"GIG":{"cityCode":"RIO","countryCode":"BR"},"GRU":{"cityCode":"SAO","countryCode":"BR"},"LHR":{"cityCode":"LON","countryCode":"GB"},"MAD":{"cityCode":"MAD","countryCode":"ES"}}},"meta":{"count":2}}},"FlightSegment":{"description":"defining a flight segment; including both operating and marketing details when applicable","properties":{"aircraft":{"$ref":"#/components/schemas/AircraftEquipment"},"arrival":{"$ref":"#/components/schemas/FlightEndPoint"},"cabin":{"description":"booking cabin / class of service of the carrier","type":"string"},"carrierCode":{"description":"providing the airline / carrier code","example":"DL","maxLength":2,"minLength":1,"type":"string"},"class":{"description":"reservation booking designator (RBD) of the carrier","maxLength":2,"minLength":1,"type":"string"},"departure":{"$ref":"#/components/schemas/FlightEndPoint"},"duration":{"description":"stop duration in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) PnYnMnDTnHnMnS format, e.g. PT2H10M","example":"PT2H10M","type":"string"},"number":{"description":"the flight number as assigned by the carrier","example":"212","maxLength":4,"minLength":1,"type":"string"},"operating":{"$ref":"#/components/schemas/OperatingFlight"},"stops":{"description":"information regarding the different stops composing the flight segment. E.g. technical stop, change of gauge...","items":{"$ref":"#/components/schemas/FlightStop"},"type":"array"},"suffix":{"description":"the flight number suffix as assigned by the carrier","maxLength":4,"minLength":1,"type":"string"}},"type":"object"},"FlightStop":{"allOf":[{"$ref":"#/components/schemas/OriginalFlightStop"},{"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","example":"2025-06-15T13:47:10.003Z","format":"date-time","type":"string"},"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","example":"2025-06-15T13:47:10.003Z","format":"date-time","type":"string"}},"type":"object"}],"description":"details of stops for direct or change of gauge flights","title":"FlightStop"},"Issue":{"properties":{"code":{"description":"an application-specific error code","format":"int64","type":"integer"},"detail":{"description":"explanation of the error","type":"string"},"source":{"description":"an object containing references to the source of the error","maxProperties":1,"properties":{"example":{"description":"a string indicating an example of the right value","type":"string"},"parameter":{"description":"a string indicating which URI query parameter caused the issue","type":"string"},"pointer":{"description":"a JSON Pointer [RFC6901] to the associated entity in the request document","type":"string"}},"title":"Issue_Source","type":"object"},"status":{"description":"the HTTP status code applicable to this error","type":"integer"},"title":{"description":"a short summary of the error","type":"string"}}},"LocationEntry":{"additionalProperties":{"$ref":"#/components/schemas/LocationValue"}},"LocationValue":{"properties":{"cityCode":{"description":"City code associated to the airport","example":"PAR","type":"string"},"countryCode":{"description":"Country code of the airport","example":"FR","type":"string"}}},"OperatingFlight":{"description":"information about the operating flight","properties":{"carrierCode":{"description":"providing the airline / carrier code","example":"DL","maxLength":2,"minLength":1,"type":"string"},"number":{"description":"the flight number as assigned by the carrier","example":"212","maxLength":4,"minLength":1,"type":"string"},"suffix":{"description":"the flight number suffix as assigned by the carrier","maxLength":4,"minLength":1,"type":"string"}},"type":"object"},"OriginalFlightEndPoint":{"description":"departure or arrival information","properties":{"iataCode":{"description":"[IATA airline codes](http://www.iata.org/publications/Pages/code-search.aspx)","example":"JFK","type":"string"},"terminal":{"description":"terminal name / number","example":"T2","type":"string"}},"type":"object"},"OriginalFlightStop":{"description":"details of stops for direct or change of gauge flights","properties":{"duration":{"description":"stop duration in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) PnYnMnDTnHnMnS format, e.g. PT2H10M","example":"PT2H10M","type":"string"},"iataCode":{"description":"[IATA airline codes](http://www.iata.org/publications/Pages/code-search.aspx)","example":"JFK","type":"string"}},"type":"object"},"Price":{"properties":{"base":{"description":"Amount without taxes","example":"632.70","type":"string"},"currency":{"example":"USD","type":"string"},"fees":{"description":"List of applicable fees","items":{"$ref":"#/components/schemas/Fee"},"type":"array"},"taxes":{"items":{"$ref":"#/components/schemas/Tax"},"type":"array"},"total":{"description":"Total amount paid by the user","example":"932.70","type":"string"}}},"PricingOptionsFareType":{"description":"type of fare of the flight-offer","example":["PUBLISHED"],"items":{"enum":["PUBLISHED","NEGOTIATED","CORPORATE"],"type":"string"},"type":"array"},"Segment":{"allOf":[{"properties":{"blacklistedInEU":{"description":"When the flight has a marketing or/and operating airline that is identified as blacklisted by the European Commission. \n\nTo 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. \nThe [list of the banned airlines](https://ec.europa.eu/transport/sites/transport/files/air-safety-list_en.pdf) 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   \n","example":false,"type":"boolean"},"co2Emissions":{"description":"Co2 informations","items":{"$ref":"#/components/schemas/Co2Emission"},"minItems":1,"type":"array"},"id":{"description":"Id of the segment","example":1,"type":"string"},"numberOfStops":{"description":"Number of stops","example":0,"type":"integer"}},"type":"object"},{"$ref":"#/components/schemas/FlightSegment"}]},"ServiceName":{"description":"type of service","enum":["PRIORITY_BOARDING","AIRPORT_CHECKIN"],"example":"PRIORITY_BOARDING","type":"string"},"SliceDiceIndicator":{"description":"slice and Dice indicator, such as Local Availability, Sub OnD(Origin and Destination) 1 Availability and Sub OnD 2 Availability","enum":["LOCAL_AVAILABILITY","SUB_OD_AVAILABILITY_1","SUB_OD_AVAILABILITY_2"],"type":"string"},"Tax":{"description":"a tax","properties":{"amount":{"example":"332.70","type":"string"},"code":{"example":"MX","type":"string"}},"type":"object"},"TermAndCondition":{"properties":{"category":{"description":"This defines what type of modification is concerned in this rule.","enum":["REFUND","EXCHANGE","REVALIDATION","REISSUE","REBOOK","CANCELLATION"],"example":"EXCHANGE","type":"string"},"circumstances":{"type":"string"},"descriptions":{"items":{"properties":{"descriptionType":{"type":"string"},"text":{"type":"string"}},"title":"Description"},"type":"array"},"maxPenaltyAmount":{"type":"string"},"notApplicable":{"type":"boolean"}}},"TravelClass":{"description":"quality of service offered in the cabin where the seat is located in this flight. Economy, premium economy, business or first class","enum":["ECONOMY","PREMIUM_ECONOMY","BUSINESS","FIRST"],"example":"PREMIUM_ECONOMY","type":"string"},"TravelerPricingFareOption":{"description":"option specifying a group of fares, which may be valid under certain conditons\nCan be used to specify special fare discount for a passenger\n","enum":["STANDARD","INCLUSIVE_TOUR","SPANISH_MELILLA_RESIDENT","SPANISH_CEUTA_RESIDENT","SPANISH_CANARY_RESIDENT","SPANISH_BALEARIC_RESIDENT","AIR_FRANCE_METROPOLITAN_DISCOUNT_PASS","AIR_FRANCE_DOM_DISCOUNT_PASS","AIR_FRANCE_COMBINED_DISCOUNT_PASS","AIR_FRANCE_FAMILY","ADULT_WITH_COMPANION","COMPANION"],"example":"STANDARD","type":"string"},"TravelerType":{"description":"traveler type\nage restrictions : CHILD < 12y, HELD_INFANT < 2y, SEATED_INFANT < 2y, SENIOR >=60y\n","enum":["ADULT","CHILD","SENIOR","YOUNG","HELD_INFANT","SEATED_INFANT","STUDENT"],"example":"ADULT","type":"string"}}}}