Amadeus Reservations
Amadeus Reservations Booking API

The Booking API from Amadeus Reservations — 5 operation(s) for booking.
Documentation GitHub OpenAPI
OpenAPI Specification

swagger: '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)."
host: test.api.amadeus.com
basePath: /v1
schemes:
- https
consumes:
- application/vnd.amadeus+json
produces:
- application/vnd.amadeus+json
tags:
- name: Booking
paths:
  /booking/flight-orders:
    post:
      tags:
      - Booking
      operationId: createFligtOrders
      summary: Amadeus Create Order Associated to the Flight Offers.
      parameters:
      - name: body
        description: list of element needed to book a flight Order
        in: body
        required: true
        schema:
          title: FlightOrderQuery
          properties:
            data:
              $ref: '#/definitions/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
      responses:
        '201':
          $ref: '#/responses/returnFlightOrders'
        '400':
          $ref: '#/responses/400_Book'
        default:
          $ref: '#/responses/500'
      description: ''
  /booking/flight-orders/{flight-orderId}:
    parameters:
    - $ref: '#/parameters/flight-orderId'
    get:
      tags:
      - Booking
      operationId: getFlightOrder
      summary: Amadeus Retrieve a Given Flight Order
      responses:
        '200':
          $ref: '#/responses/returnFlightOrders'
        '400':
          $ref: '#/responses/400_GET_Order'
        '404':
          $ref: '#/responses/404'
        default:
          $ref: '#/responses/500'
      description: ''
    delete:
      tags:
      - Booking
      operationId: cancelFlightOrder
      summary: Amadeus Cancel a Given Flight Order
      responses:
        '204':
          $ref: '#/responses/204'
        '400':
          $ref: '#/responses/400_DELETE_Order'
        '404':
          $ref: '#/responses/404'
        default:
          $ref: '#/responses/500'
      description: ''
  /booking/hotel-orders:
    post:
      summary: Amadeus Create Hotel Order
      tags:
      - Booking
      description: ''
      operationId: createHotelOrder
      responses:
        '201':
          description: Created
          schema:
            type: object
            properties:
              data:
                $ref: '#/definitions/HotelOrder'
              warnings:
                type: array
                items:
                  $ref: '#/definitions/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"
          schema:
            $ref: '#/definitions/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"
          schema:
            $ref: '#/definitions/Errors'
      parameters:
      - in: body
        name: body
        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: '#/definitions/Guest'
                required:
                - type
                - guests
              - $ref: '#/definitions/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
        description: ''
  /ordering/transfer-orders:
    post:
      tags:
      - Booking
      operationId: createTransferOrder
      summary: Amadeus Performs a Transfer Reservation.
      parameters:
      - in: query
        name: offerId
        type: string
        required: true
        description: transfer offer id from shopping/transfer-offers response
      - name: body
        in: body
        required: true
        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. Mandatory if service provider has setting "FLIGHT_NUMBER_REQUIRED"
                  type: string
                passengers:
                  type: array
                  items:
                    $ref: '#/definitions/Passenger'
                agency:
                  $ref: '#/definitions/Agency'
                payment:
                  $ref: '#/definitions/Payment'
                equipment:
                  type: array
                  items:
                    $ref: '#/definitions/Equipment'
                extraServices:
                  type: array
                  items:
                    $ref: '#/definitions/ExtraService'
                loyaltyNumber:
                  $ref: '#/definitions/LoyaltyNumber'
                corporation:
                  $ref: '#/definitions/Corporation'
                startConnectedSegment:
                  $ref: '#/definitions/TravelSegment'
                endConnectedSegment:
                  $ref: '#/definitions/TravelSegment'
              example:
                data:
                  note: Note to driver
                  passengers:
                  - firstName: John
                    lastName: Doe
                    title: MR
                    contacts:
                      phoneNumber: '+33123456789'
                      email: user@email.com
                    billingAddress:
                      line: Avenue de la Bourdonnais, 19
                      zip: '75007'
                      countryCode: FR
                      cityName: Paris
                  agency:
                    contacts:
                    - email:
                        address: abc@test.com
                  payment:
                    methodOfPayment: CREDIT_CARD
                    creditCard:
                      number: '4111111111111111'
                      holderName: JOHN DOE
                      vendorCode: VI
                      expiryDate: '1018'
                      cvv: '111'
                  extraServices:
                  - code: EWT
                    itemId: EWT0291
                  equipment:
                  - code: BBS
                  corporation:
                    address:
                      line: 5 Avenue Anatole France
                      zip: '75007'
                      countryCode: FR
                      cityName: Paris
                    info:
                      AU: FHOWMD024
                      CE: 280421GH
                  startConnectedSegment

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

Documentation

Specifications

Other Resources

OpenAPI Specification
