Send Special Request

If a customer has special requests, you can send special requests using the Booking API when creating the booking or the Special Request API after the booking is created.

How to send special request:

  • when creating a booking: You can include special requests directly by using the Booking API.
  • After a Booking is Created: Special requests can be submitted via either through the Amendment API or Special Request API . (Note: We recommend using the Amendment API for all post-booking special requests to ensure a smooth and consistent experience.)

Special Request API - Request Example

{
  "bookingId": 80000040,
  "specialRequest": "High Floor"
}

Parameters for Special Request Schema (* = Require)

Element
Attribute
Description
SpecialRequestV4 bookingId*
integer
Booking Identifier

specialRequest*
string

Requests can be made in English or the hotel's local language.

  • English: The maximum number of characters allowed is 4,000.
  • Chinese, Japanese, Korean: The maximum number of characters allowed is 2,000.

Special Request API - Response Example (Correct case)

{}

Parameters for Special Request Response Schema (Correct case) (* = Required)

Success response returns status without body message.

Special Request API - Response Example (Error case)

{
    "errorMessage": {
        "id": "909",
        "message": "Site id is not match. booking id: 80000040 site id: 1888679"
    }
}

Parameters for Special Request Response Schema (Error case) (* = Require)

Element
Attribute
Description
SpecialRequestResponseV4 -> errorMessage id*
string
Details are on Response Body Part (Appendix)

subId
string


message
string
Details are on Response Body Part (Appendix)