Amadeus Reservations Booking API

The Booking API from Amadeus Reservations — 5 operation(s) for booking.

Operations 6

POST /booking/flight-orders Amadeus Create Order Associated to the Flight Offers. #
GET /booking/flight-orders/{flight-orderId} Amadeus Retrieve a Given Flight Order #
DELETE /booking/flight-orders/{flight-orderId} Amadeus Cancel a Given Flight Order #
POST /booking/hotel-orders Amadeus Create Hotel Order #
POST /ordering/transfer-orders Amadeus Performs a Transfer Reservation. #
POST /ordering/transfer-orders/{orderId}/transfers/cancellation Amadeus Cancel a Transfer in an Existing OrderId. #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/amadeus-reservations-booking-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

amadeus-reservations-booking-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  version: 1.10.0
  title: Flight Create Orders Booking API
  x-tags:
  - '#travel-booking'
  - '#quick-connect'
  - '#mobile-services'
  - '#ama-for-dev'
  x-status: validated
  x-release-note:
    1.10.0:
    - Add chargeableSeat element
    - Add lastTicketingDateTime
    1.9.0:
    - Add FormIdentification into the flight-order
    1.8.0:
    - Add new source "NDC" - **only available in Enterprise**
    1.7.0:
    - Add new PaymentBrand enum "PYTON" - **only available in Enterprise**
    - Add new OtherPaymentMethod enum "PYTON" - **only available in Enterprise**
    - Add FM Commission - **only available in Enterprise**
    1.6.0:
    - Add Margins and Discounts content from Margin Manager product - **only available in Enterprise**
    1.5.0:
    - Add new General Remark enum "TOUR_CODE"
    1.4.0:
    - Add new Gender enum "UNSPECIFIED" and "UNDISCLOSED"
    - Add EasyPay credit card brand - **only available in Enterprise**
    1.3.0:
    - Add new airlineRemark subtype "ADVANCED_TICKET_TIME_LIMIT"
    1.2.0:
    - Add new sources "LTC" and "EAC" - **only available in Enterprise**
    1.1.0:
    - Add Co2Emissions information into Create flight-order reply
    - Add language in Contact for the APN feature
    1.0.0:
    - Initial version
  description: "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. \n\nPlease 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)."
servers:
- url: https://test.api.amadeus.com/v1
tags:
- name: Booking
paths:
  /booking/flight-orders:
    post:
      tags:
      - Booking
      operationId: createFligtOrders
      summary: Amadeus Create Order Associated to the Flight Offers.
      responses:
        '201':
          $ref: '#/components/responses/returnFlightOrders'
        '400':
          $ref: '#/components/responses/400_Book'
        default:
          $ref: '#/components/responses/500'
      description: ''
      requestBody:
        content:
          application/vnd.amadeus+json:
            schema:
              title: FlightOrderQuery
              properties:
                data:
                  $ref: '#/components/schemas/FlightOrder'
              example:
                data:
                  type: flight-order
                  flightOffers:
                  - type: flight-offer
                    id: '1'
                    source: GDS
                    instantTicketingRequired: false
                    nonHomogeneous: false
                    paymentCardRequired: false
                    lastTicketingDate: '2020-03-01'
                    itineraries:
                    - segments:
                      - departure:
                          iataCode: GIG
                          terminal: '2'
                          at: '2020-03-01T21:05:00'
                        arrival:
                          iataCode: CDG
                          terminal: 2E
                          at: '2020-03-02T12:20:00'
                        carrierCode: KL
                        number: '2410'
                        aircraft:
                          code: '772'
                        operating:
                          carrierCode: AF
                        duration: PT11H15M
                        id: '40'
                        numberOfStops: 0
                      - departure:
                          iataCode: CDG
                          terminal: 2F
                          at: '2020-03-02T14:30:00'
                        arrival:
                          iataCode: AMS
                          at: '2020-03-02T15:45:00'
                        carrierCode: KL
                        number: '1234'
                        aircraft:
                          code: 73H
                        operating:
                          carrierCode: KL
                        duration: PT1H15M
                        id: '41'
                        numberOfStops: 0
                      - departure:
                          iataCode: AMS
                          at: '2020-03-02T17:05:00'
                        arrival:
                          iataCode: MAD
                          terminal: '2'
                          at: '2020-03-02T19:35:00'
                        carrierCode: KL
                        number: '1705'
                        aircraft:
                          code: 73J
                        operating:
                          carrierCode: KL
                        duration: PT2H30M
                        id: '42'
                        numberOfStops: 0
                    - segments:
                      - departure:
                          iataCode: MAD
                          terminal: '2'
                          at: '2020-03-05T20:25:00'
                        arrival:
                          iataCode: AMS
                          at: '2020-03-05T23:00:00'
                        carrierCode: KL
                        number: '1706'
                        aircraft:
                          code: 73J
                        operating:
                          carrierCode: KL
                        duration: PT2H35M
                        id: '81'
                        numberOfStops: 0
                      - departure:
                          iataCode: AMS
                          at: '2020-03-06T10:40:00'
                        arrival:
                          iataCode: GIG
                          terminal: '2'
                          at: '2020-03-06T18:35:00'
                        carrierCode: KL
                        number: '705'
                        aircraft:
                          code: '772'
                        operating:
                          carrierCode: KL
                        duration: PT11H55M
                        id: '82'
                        numberOfStops: 0
                    price:
                      currency: USD
                      total: '8514.96'
                      base: '8314.00'
                      fees:
                      - amount: '0.00'
                        type: SUPPLIER
                      - amount: '0.00'
                        type: TICKETING
                      - amount: '0.00'
                        type: FORM_OF_PAYMENT
                      grandTotal: '8514.96'
                      billingCurrency: USD
                    pricingOptions:
                      fareType:
                      - PUBLISHED
                      includedCheckedBagsOnly: true
                    validatingAirlineCodes:
                    - AF
                    travelerPricings:
                    - travelerId: '1'
                      fareOption: STANDARD
                      travelerType: ADULT
                      price:
                        currency: USD
                        total: '4849.48'
                        base: '4749.00'
                        taxes:
                        - amount: '31.94'
                          code: BR
                        - amount: '14.68'
                          code: CJ
                        - amount: '5.28'
                          code: FR
                        - amount: '17.38'
                          code: JD
                        - amount: '0.69'
                          code: OG
                        - amount: '3.95'
                          code: QV
                        - amount: '12.12'
                          code: QX
                        - amount: '14.44'
                          code: RN
                      fareDetailsBySegment:
                      - segmentId: '40'
                        cabin: BUSINESS
                        fareBasis: CFFBR
                        brandedFare: BUSINESS
                        class: C
                        includedCheckedBags:
                          quantity: 2
                      - segmentId: '41'
                        cabin: BUSINESS
                        fareBasis: CFFBR
                        brandedFare: BUSINESS
                        class: J
                        includedCheckedBags:
                          quantity: 2
                      - segmentId: '42'
                        cabin: BUSINESS
                        fareBasis: CFFBR
                        brandedFare: BUSINESS
                        class: J
                        includedCheckedBags:
                          quantity: 2
                      - segmentId: '81'
                        cabin: ECONOMY
                        fareBasis: YFFBR
                        brandedFare: FULLFLEX
                        class: Y
                        includedCheckedBags:
                          quantity: 1
                      - segmentId: '82'
                        cabin: ECONOMY
                        fareBasis: YFFBR
                        brandedFare: FULLFLEX
                        class: Y
                        includedCheckedBags:
                          quantity: 1
                    - travelerId: '2'
                      fareOption: STANDARD
                      travelerType: CHILD
                      price:
                        currency: USD
                        total: '3665.48'
                        base: '3565.00'
                        taxes:
                        - amount: '31.94'
                          code: BR
                        - amount: '14.68'
                          code: CJ
                        - amount: '5.28'
                          code: FR
                        - amount: '17.38'
                          code: JD
                        - amount: '0.69'
                          code: OG
                        - amount: '3.95'
                          code: QV
                        - amount: '12.12'
                          code: QX
                        - amount: '14.44'
                          code: RN
                      fareDetailsBySegment:
                      - segmentId: '40'
                        cabin: BUSINESS
                        fareBasis: CFFBR
                        brandedFare: BUSINESS
                        class: C
                        includedCheckedBags:
                          quantity: 2
                      - segmentId: '41'
                        cabin: BUSINESS
                        fareBasis: CFFBR
                        brandedFare: BUSINESS
                        class: J
                        includedCheckedBags:
                          quantity: 2
                      - segmentId: '42'
                        cabin: BUSINESS
                        fareBasis: CFFBR
                        brandedFare: BUSINESS
                        class: J
                        includedCheckedBags:
                          quantity: 2
                      - segmentId: '81'
                        cabin: ECONOMY
                        fareBasis: YFFBR
                        brandedFare: FULLFLEX
                        class: Y
                        includedCheckedBags:
                          quantity: 1
                      - segmentId: '82'
                        cabin: ECONOMY
                        fareBasis: YFFBR
                        brandedFare: FULLFLEX
                        class: Y
                        includedCheckedBags:
                          quantity: 1
                  travelers:
                  - id: '1'
                    dateOfBirth: '1982-01-16'
                    name:
                      firstName: JORGE
                      lastName: GONZALES
                    gender: MALE
                    contact:
                      emailAddress: jorge.gonzales833@telefonica.es
                      phones:
                      - deviceType: MOBILE
                        countryCallingCode: '34'
                        number: '480080076'
                    documents:
                    - documentType: PASSPORT
                      birthPlace: Madrid
                      issuanceLocation: Madrid
                      issuanceDate: '2015-04-14'
                      number: '00000000'
                      expiryDate: '2025-04-14'
                      issuanceCountry: ES
                      validityCountry: ES
                      nationality: ES
                      holder: true
                  - id: '2'
                    dateOfBirth: '2012-10-11'
                    gender: FEMALE
                    contact:
                      emailAddress: jorge.gonzales833@telefonica.es
                      phones:
                      - deviceType: MOBILE
                        countryCallingCode: '34'
                        number: '480080076'
                    name:
                      firstName: ADRIANA
                      lastName: GONZALES
                  remarks:
                    general:
                    - subType: GENERAL_MISCELLANEOUS
                      text: ONLINE BOOKING FROM INCREIBLE VIAJES
                  ticketingAgreement:
                    option: DELAY_TO_CANCEL
                    delay: 6D
                  contacts:
                  - addresseeName:
                      firstName: PABLO
                      lastName: RODRIGUEZ
                    companyName: INCREIBLE VIAJES
                    purpose: STANDARD
                    phones:
                    - deviceType: LANDLINE
                      countryCallingCode: '34'
                      number: '480080071'
                    - deviceType: MOBILE
                      countryCallingCode: '33'
                      number: '480080072'
                    emailAddress: support@increibleviajes.es
                    address:
                      lines:
                      - Calle Prado, 16
                      postalCode: '28014'
                      cityName: Madrid
                      countryCode: ES
        description: list of element needed to book a flight Order
        required: true
  /booking/flight-orders/{flight-orderId}:
    parameters:
    - $ref: '#/components/parameters/flight-orderId'
    get:
      tags:
      - Booking
      operationId: getFlightOrder
      summary: Amadeus Retrieve a Given Flight Order
      responses:
        '200':
          $ref: '#/components/responses/returnFlightOrders'
        '400':
          $ref: '#/components/responses/400_GET_Order'
        '404':
          $ref: '#/components/responses/404'
        default:
          $ref: '#/components/responses/500'
      description: ''
    delete:
      tags:
      - Booking
      operationId: cancelFlightOrder
      summary: Amadeus Cancel a Given Flight Order
      responses:
        '204':
          $ref: '#/components/responses/204'
        '400':
          $ref: '#/components/responses/400_DELETE_Order'
        '404':
          $ref: '#/components/responses/404'
        default:
          $ref: '#/components/responses/500'
      description: ''
  /booking/hotel-orders:
    post:
      summary: Amadeus Create Hotel Order
      tags:
      - Booking
      description: ''
      operationId: createHotelOrder
      responses:
        '201':
          description: Created
          content:
            application/vnd.amadeus+json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/HotelOrder'
                  warnings:
                    type: array
                    items:
                      $ref: '#/components/schemas/Warning'
                example:
                  data:
                    type: hotel-order
                    id: V0g2VFJaLzIwMjQtMDYtMDc=
                    hotelBookings:
                    - type: hotel-booking
                      id: MS84OTkyMjcxMC85MDIyNDU0OQ==
                      bookingStatus: CONFIRMED
                      hotelProviderInformation:
                      - hotelProviderCode: AR
                        confirmationNumber: '89922710'
                      roomAssociations:
                      - hotelOfferId: '******'
                        guestReferences:
                        - guestReference: '1'
                      hotelOffer:
                        id: '******'
                        type: hotel-offer
                        category: TYPE_CONDITIONAL
                        checkInDate: '2024-06-07'
                        checkOutDate: '2024-06-08'
                        guests:
                          adults: 1
                        policies:
                          cancellations:
                          - amount: '215.05'
                            deadline: '2024-06-06T23:59:00+02:00'
                          paymentType: GUARANTEE
                        price:
                          base: '195.50'
                          currency: EUR
                          sellingTotal: '215.05'
                          taxes:
                          - amount: '19.55'
                            code: VALUE_ADDED_TAX
                            currency: EUR
                            included: false
                            pricingFrequency: PER_STAY
                            pricingMode: PER_PRODUCT
                          total: '215.05'
                          variations:
                            changes:
                            - endDate: '2024-06-08'
                              startDate: '2024-06-07'
                              base: '195.50'
                              currency: EUR
                        rateCode: S9R
                        room:
                          description:
                            lang: EN
                            text: Marriott Senior Discount, includes
                          type: XMI
                        roomQuantity: 1
                      hotel:
                        hotelId: ARMADAIT
                        chainCode: AR
                        name: AC BY MARRIOTT HOTEL AITANA
                        self: https://test.travel.api.amadeus.com/v1/reference-data/locations/by-hotel/ARMADAIT
                      payment:
                        method: CREDIT_CARD
                        paymentCard:
                          paymentCardInfo:
                            vendorCode: VI
                            cardNumber: 415128XXXXXX1370
                            expiryDate: 0826
                            holderName: BOB SMITH
                      travelAgentId: '00000000'
                    guests:
                    - tid: 1
                      id: 1
                      title: MR
                      firstName: BOB
                      lastName: SMITH
                      phone: '+33679278416'
                      email: bob.smith@email.com
                    associatedRecords:
                    - reference: WH6TRZ
                      originSystemCode: GDS
                    self: http://test.api.amadeus.com/v2/booking/hotel-orders/V0g2VFJaLzIwMjQtMDYtMDc=
        '400':
          description: "Bad Request\n\ncode    | title                               | owner       | pointer               | description\n--------|-----------------------------------  |-----------  |------------------     |------------------------------------------\n477   |  INVALID FORMAT                                                |  Amadeus   | data        | If present, detail field gives more information about the parameter missing or invalid. Please correct the parameter in the request.\n8612   |  INVALID TYPE                                                  |Amadeus     |data/type     |  The type inside the data element is incorrect. Please correct the request.\n38420   |  OFFER NOT FOUND                                                |Amadeus      | data/roomAssociations/hotelOfferId  | The Offer ID put in request does not exist or has expired. Please use a valid Offer ID or get a new Offer ID.\n36801   |  INVALID OFFER ID                                              |   Amadeus   |  data/roomAssociations/hotelOfferId  | Check all the references of offer ID in the request.\n4725    |  INVALID PASSENGER ASSOCIATION                                 |  Amadeus    | data/roomAssociations  | Incoherence between the guests defined and the guests in room association. Please check number of guests and guest IDs.\n33555   |  NUMBER OF ROOMS MISMATCH BETWEEN SHOPPING AND BOOKING          |Amadeus       | data/roomAssociations |  Different number of rooms requested between Shopping and Booking\n3843    |  NUMBER IN PARTY EXCEEDS ROOM OCCUPANCY LIMIT                  |Amadeus      | data/guests or data/roomAssociations  |Too many guests in the room.\n27530   |  AT LEAST ONE ADULT IS REQUIRED                                |  Amadeus     |data/guests or data/roomAssociations     |  No adult was put as a guest\n1503    |  INVALID NUMBER OF GUESTS                    |Amadeus                    |data/guests or data/roomAssociations                    |Different number of guests requested between Shopping and Booking\n1295    |  /ID- NOT RECOGNISED                    |Hotel provider                    |data/roomAssociations/guestsReferences/hotelLoyaltyId     |The hotelLoyaltyId is not recognized by the Hotel provider.\n2997    |  RESTRICTED OPTION-NOT ALLOWED -- /FT-                    |Amadeus                    |data/guests/frequentTraveler                    |The Airline frequent flyer number is not supported by the Hotel provider.\n3215    |  INVALID LENGTH ON OPTION FOR CHAIN GIVEN -- /SI-                    |Amadeus                    |data/roomAssociations/specialRequest                    |Too long specialRequest.\n1421    |  /SI-INVALID FORMAT           |Amadeus             |data/roomAssociations/specialRequest           |Invalid format for specialRequest.\n1146    |  DEPOSIT REQUIRED                  |  Amadeus                  |   data/payment  \n1427    |  GUARANTEE REQUIRED                  |  Amadeus                  |   data/payment  \n38592   |  INVALID METHOD OF PAYMENT                  |  Hotel provider                  |   data/payment  \n38529   |  INVALID PREPAY                  |  Hotel provider                  |   data/payment  \n37576   |  INVALID PAYMENT METHOD                  |  Hotel provider                  |   data/payment  \n1207    |  Invalid Form of Guarantee                  |  Hotel provider                  |   data/payment\n1317    |  Invalid Form of Deposit                  |  Hotel provider                  |   data/payment  \n12018   |  INVALID BOOKING SOURCE NUMBER+\" /BS-\"                    |Amadeus          | data/payment                    |Travel Agend ID provided in input is incorrect.\n3659    |  CREDIT CARD DEPOSIT REQUIRED                    |Hotel provider                    | data/payment/paymentCard  \n1205    |  INVALID CREDIT CARD TYPE                    |Amadeus                    |data/payment/paymentCard/paymentCardInfo/vendorCode  \n8517    |  INVALID CREDIT CARD NUMBER                    |Hotel provider                    |data/payment/paymentCard/paymentCardInfo/cardNumber  \n1240    |  NO CREDIT CARD NUMBER GIVEN                    |Amadeus                    |data/payment/paymentCard/paymentCardInfo/cardNumber  \n28926   |  MISSING CARD VERIFICATION VALUE CVV                    |Hotel provider                    |data/payment/paymentCard/paymentCardInfo/securityCode  \n6842    |  ERR INVALID SECURITY CODE(S)                    |Hotel provider                    |data/payment/paymentCard/paymentCardInfo/securityCode  \n22425   |  CREDIT_CARD_SECURITY_CODE_REQUIRED_/G-                    |Hotel provider                    |data/payment/paymentCard/paymentCardInfo/securityCode  \n22426   |  CREDIT_CARD_SECURITY_CODE_REQUIRED_/DP                    |Hotel provider                    |data/payment/paymentCard/paymentCardInfo/securityCode  \n3682    |  CREDIT CARD NOT ACCEPTED AT HOTEL PROPERTY                    |Hotel provider                    |data/payment/paymentCard/paymentCardInfo/vendorCode                    |Credit card are not accepted by this hotel property. Please use another method of payment.\n24550   |  ERROR IN CREDIT CARD DATE /DP-                    |Hotel provider                    |data/payment/paymentCard/paymentCardInfo/expiryDate                    |Issue with credit card expiration date. Please correct.\n39871   |  VIRTUAL CREDIT CARD NOT ACCEPTED AT PROPERTY                    |Hotel provider                     |data/payment/billBack or data/payment/paymentCard/VCC                    |Please do not use a virtual credit card to book at this Hotel property.\n32315   |  PAYMENT TRANSACTION FAILED. PLEASE CHECK YOUR CREDIT CARD DATA    |Hotel provider |  data/payment/paymentCard/paymentCardInfo  \n41347   |  3DS AUTHENTIFICATION NOT PERMITTED                    |Hotel provider                    |data/payment/paymentCard/paymentCardInfo/threeDomainSecure  \n4926   |  INVALID DATA RECEIVED                    |Amadeus                    |data/payment/paymentCard/paymentCardInfo/threeDomainSecure                    |The 3DS information of the credit card does not match the ones expected for the version. Please correct it.\n5020   |  INVALID OWNER                    |Amadeus                    |data/payment/paymentCard/paymentCardInfo/threeDomainSecure                    |For Amadeus Value Hotel booking, it is mandatory to provide the owner of the credit card. Please check which credit card owner are activated for your Office.\n39283   |  CREDIT CARD AUTHORIZATION TIME-OUT        |Amadeus    \n15595   |  INVALID PRICING REQUEST                    |Amadeus                      |                  |Cannot book. Please use another Offer ID.\n12030   |  PRICING INFORMATION MISSING.                     |Amadeus                  |                      |Cannot book. Please use another Offer ID.\n37200   |  PRICE DISCREPANCY                    |Hotel provider                      |                  |Hotel provider response has a discrepancy in rate amount. Please restart from the shopping.\n41344   |  CANCELLATION DISCREPANCY                   |  Hotel provider                    |                  |  Hotel provider response has a discrepancy in cancellation policy. Please restart from the shopping.\n25860   |  CHECK VOUCHER RECEPTION AND CALL HELPDESK - BOOKING FAILURE                    |Amadeus                        |                |Link down between Amadeus and the Hotel provider. Please check before retrying that the booking is not created in the Hotel provider system.\n3664   |  NO ROOMS AVAILABLE AT REQUESTED PROPERTY                  |Hotel provider            |      |    No availability on hotel hotel provider side.\n1297   |  ROOM TYPE NOT AT LOCATION                    |Hotel provider                         |           |    Room type not available. Other room types could be available.\n3289   |  RATE NOT AVAILABLE FOR REQUESTED DATES                    |Hotel provider      |    |  No availability on hotel provider side. Same rate could be available at other dates.\n1999   |  ROOM TYPE / RATE CODE NOT AVAILABLE                    |Hotel provider                    |                  |  No availability on hotel provider side. Other room types could be available.\n3494   |  ROOM OR RATE NOT AVAILABLE OR RESTRICTED                    |Hotel provider                  |               |No availability on hotel provider side.\n6698   |  RATE NOT LOADED                    |Hotel provider                      |          |Rate does not exists on hotel provider side.\n12247   |  NO RATE FOR REQUESTED OCCUPANCY - RE-ENTER WITH LOWER OCCUPANCY                    |Hotel provider\n33440   |  THIS PROPERTY IS BLACKLISTED FOR YOUR OFFICE                    |Amadeus        |      |It is forbidden to book this hotel property from your country.\n"
          content:
            application/vnd.amadeus+json:
              schema:
                $ref: '#/components/schemas/Errors'
        '500':
          description: "Internal Server Error\n\ncode    | title                                                 | owner    \n------- | ----------------------------------------------------- | ---------------\n00011   | UNABLE TO PROCESS                                     | Hotel provider\n04070   | UNABLE TO PROCESS - CONTACT HELP DESK                 | Amadeus\n16440   | BILLBACK ERROR - External Security System             | Amadeus\n31686   | BILLBACK NOT AVAILABLE - PLEASE RETRY LATER            | Amadeus\n21934   | UNABLE TO PROCESS - TIMEOUT                           | Amadeus\n38660   | UNABLE TO CREATE THE ORDER - FAILED ON PROVIDER SIDE  | Hotel provider\n42150   | PSD2 AUTHENTICATION CANNOT BE PERFORMED                | Amadeus\n"
          content:
            application/vnd.amadeus+json:
              schema:
                $ref: '#/components/schemas/Errors'
      requestBody:
        content:
          application/vnd.amadeus+json:
            schema:
              type: object
              properties:
                data:
                  allOf:
                  - type: object
                    properties:
                      type:
                        type: string
                        description: '"hotel-order" to create an hotel order'
                      guests:
                        type: array
                        description: This is the list of all the guests with detailed information.
                        items:
                          allOf:
                          - type: object
                            properties:
                              tid:
                                type: integer
                                description: "The tid is a temporary id of a guest. \n- It correlates a given guest with a room in the roomAssociation section.\n- It is arbitrarily chosen by the user and is unique."
                            required:
                            - tid
                          - $ref: '#/components/schemas/Guest'
                    required:
                    - type
                    - guests
                  - $ref: '#/components/schemas/CreateHotelBooking'
              example:
                data:
                  type: hotel-order
                  guests:
                  - tid: 1
                    title: MR
                    firstName: BOB
                    lastName: SMITH
                    phone: '+33679278416'
                    email: bob.smith@email.com
                  travelAgent:
                    contact:
                      email: bob.smith@email.com
                  roomAssociations:
                  - guestReferences:
                    - guestReference: '1'
                    hotelOfferId: 4L8PRJPEN7
                  payment:
                    method: CREDIT_CARD
                    paymentCard:
                      paymentCardInfo:
                        vendorCode: VI
                        cardNumber: '4151289722471370'
                        expiryDate: 2026-08
                        holderName: BOB SMITH
  /ordering/transfer-orders:
    post:
      tags:
      - Booking
      operationId: createTransferOrder
      summary: Amadeus Performs a Transfer Reservation.
      parameters:
      - in: query
        name: offerId
        required: true
        description: transfer offer id from shopping/transfer-offers response
        schema:
          type: string
      responses:
        '201':
          $ref: '#/components/responses/transfer_order'
        '400':
          $ref: '#/components/responses/400_createTransferOrder'
        '401':
          $ref: '#/components/responses/401'
        default:
          $ref: '#/components/responses/500_2'
      description: ''
      requestBody:
        content:
          application/vnd.amadeus+json:
            schema:
              title: Body_Reservation
              required:
              - data
              properties:
                data:
                  type: object
                  title: Body_Reservation_Data
                  required:
                  - passengers
                  - payment
                  properties:
                    note:
                      description: note to driver
                      type: string
                    flightNumber:
                      description: flight number. Mandat

# --- truncated at 32 KB (199 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/amadeus-reservations/refs/heads/main/openapi/amadeus-reservations-booking-api-openapi.yml