APapaleo
Booking

Add one or multiple reservations to an existing booking.

Changed on

Creates new reservations and adds them to an existing booking taking a list of reservations as input<br>You must have at least one of these scopes: 'reservations.create, reservations.manage'.<br>For fine-grained clients, you must have this permission: 'core.bookings.modify'.

post/booking/v1/bookings/{id}/reservations

Request

  • Base URL
    https://api.apaleo.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.apaleo.com/booking/v1/bookings/{id}/reservations
  • Auth
    OAuth 2
    Implicit: https://identity.apaleo.com/connect/authorize
    Scopes: reservations.create, reservations.manage, admin

Path parameters

idstring required

Id of the booking the reservations should be attached to.

Headers

Idempotency-Keystring

Unique key for safely retrying requests without accidentally performing the same operation twice. We'll always send back the same response for requests made with the same key, and keys can't be reused with different request parameters. Keys expire after 24 hours.

Request body

transactionReferencestring nullable

The reference of a payment transaction. This should be set when a payment transaction has been initiated and should be used to complete the transaction upon reservation creation. When set, the payment transaction completion is always triggered regardless of the reservation guarantee type and payment automation settings.

Example request

{
  "reservations": [
    {
      "arrival": "2026-10-17",
      "departure": "2026-10-19",
      "adults": 1,
      "comment": "I need a wake up service",
      "externalCode": "812864414|381",
      "channelCode": "BookingCom",
      "primaryGuest": {
        "title": "Mr",
        "gender": "Male",
        "firstName": "Jon",
        "middleInitial": "D",
        "lastName": "Doe",
        "email": "john.d@doe.com",
        "phone": "+4989123343",
        "address": {
          "addressLine1": "My Street 1",
          "postalCode": "12453",
          "city": "MyCity",
          "countryCode": "GB"
        },
        "vehicleRegistration": {
          "number": "APA322",
          "countryCode": "DE"
        }
      },
      "guaranteeType": "Prepayment",
      "timeSlices": [
        {
          "ratePlanId": "MUC-NONREF-DBL"
        },
        {
          "ratePlanId": "MUC-NONREF-DBL"
        }
      ],
      "services": [
        {
          "serviceId": "MUC-BRKF"
        },
        {
          "serviceId": "MUC-YOGA",
          "dates": [
            {
              "serviceDate": "2026-10-18",
              "amount": {
                "amount": 35,
                "currency": "EUR"
              }
            }
          ]
        }
      ],
      "companyId": "UMBRELLA",
      "corporateCode": "UMBRELLA-MUC_NONREF_DBL"
    },
    {
      "arrival": "2026-10-18",
      "departure": "2026-10-20",
      "adults": 1,
      "childrenAges": [
        6
      ],
      "channelCode": "Direct",
      "primaryGuest": {
        "title": "Mr",
        "gender": "Male",
        "firstName": "Eric",
        "middleInitial": "E",
        "lastName": "Steinmetz",
        "email": "eric.e@steinmetz.com",
        "phone": "+4989123343",
        "address": {
          "addressLine1": "My Street 1",
          "postalCode": "12453",
          "city": "MyCity",
          "countryCode": "GB"
        },
        "vehicleRegistration": {
          "number": "APA322",
          "countryCode": "DE"
        }
      },
      "guaranteeType": "CreditCard",
      "timeSlices": [
        {
          "ratePlanId": "BER-FLEX-DBL"
        },
        {
          "ratePlanId": "BER-FLEX-DBL"
        }
      ],
      "commission": {
        "commissionAmount": {
          "amount": 20,
          "currency": "EUR"
        },
        "beforeCommissionAmount": {
          "amount": 100,
          "currency": "EUR"
        }
      }
    }
  ],
  "transactionReference": "RFEUFHEW"
}

Response

All new reservations were created and added to the booking.

Example response

{
  "reservationIds": [
    {
      "id": "XPGMSXGF-1"
    },
    {
      "id": "XPGMSXGF-2"
    }
  ]
}

Changes