Book a quote
Write. Confirms a quote. Requires Idempotency-Key. Availability is re-checked under a lock, so
two partners can never book the last room. If the quote has an active hold, the hold is converted.
post
https://api.konghotels.cloud/reservations
Headers
Idempotency-Keystringrequired
Required. A unique key (UUID recommended) per booking attempt; reuse it when retrying.
<= 255 characters
Example:8e03978e-40d5-43e8-bc93-6894a57f9324
Body
application/json
Body
application/json
ReservationRequest
quote_idstringrequired
payment_modelstringrequired
pay_at_hotel: the guest pays the property; partner_collect: you collected payment and settle
with Kong Hotels under your contract (shown as a prepayment on the folio).
Allowed values:pay_at_hotelpartner_collect
partner_referencestring | null
Your booking reference; searchable via GET /reservations?partner_reference=.
<= 64 characters
guestobjectrequired
Show Child Parameters
additional_guestsarray[object]
Show Child Parameters
children_agesarray[integer]
>= 0<= 17
special_requestsstring | null
<= 2000 characters
estimated_arrival_timestring | null
Match pattern:^\d{2}:\d{2}$
Response
application/json
Response
application/json
Reservation confirmed.
dataobject
Show Child Parameters
post/reservations
Authentication
Headers
Body
{
"quote_id": "qt_01jbx4m6n2kz9v8c7d5e3f1g0h",
"payment_model": "pay_at_hotel",
"partner_reference": "BKG-88231001",
"guest": {
"first_name": "Ann",
"last_name": "Darrow",
"email": "ann.darrow@example.com",
"phone": "+1 212 555 0100",
"country_code": "US"
},
"additional_guests": [
{
"first_name": "Jack",
"last_name": "Driscoll"
}
],
"special_requests": "High floor, away from the elevator.",
"estimated_arrival_time": "18:30"
}
application/json
Get a reservation
get
https://api.konghotels.cloud/reservations/{confirmationNumber}
Path Parameters
confirmationNumberstringrequired
Example:KH4DEMO01
Response
application/json
Response
application/json
The reservation.
dataobject
Show Child Parameters
get/reservations/{confirmationNumber}
Authentication
Path Parameters
application/json
Modify a reservation
Write. Send only the fields to change.
- Guest details (
guestis merged),additional_guests,special_requests,
estimated_arrival_time,partner_reference,children_ages: applied as-is. - Stay changes (
check_in,check_out,adults,children,rooms,room_type_code,
rate_plan_code): availability is re-checked, the stay is re-priced at current rates with the
original promotion and add-ons, andmeta.price_differenceshows the change. Not allowed on
rate plans withallows_modification: falseor once the stay has started.
patch
https://api.konghotels.cloud/reservations/{confirmationNumber}
Path Parameters
confirmationNumberstringrequired
Example:KH4DEMO01
Body
application/json
Body
application/json
ReservationUpdate
check_instring(date)
check_outstring(date)
adultsinteger
childreninteger
roomsinteger
room_type_codestring
rate_plan_codestring
guestobject
Merged into the existing guest details.
Show Child Parameters
additional_guestsarray[object]
Show Child Parameters
children_agesarray[integer]
special_requestsstring | null
estimated_arrival_timestring | null
partner_referencestring | null
Response
application/json
Response
application/json
Updated reservation.
dataobject
Show Child Parameters
metaobject
Show Child Parameters
patch/reservations/{confirmationNumber}
Authentication
Path Parameters
Body
{
"check_out": "2026-12-08",
"special_requests": "Celebrating an anniversary."
}
application/json
Get the cancellation fee
The fee that would apply if the reservation were cancelled right now, with the policy terms.
get
https://api.konghotels.cloud/reservations/{confirmationNumber}/cancellation-quote
Path Parameters
confirmationNumberstringrequired
Example:KH4DEMO01
Response
application/json
Response
application/json
Cancellation quote.
dataobject
Show Child Parameters
get/reservations/{confirmationNumber}/cancellation-quote
Authentication
Path Parameters
application/json
Cancel a reservation
Write. Cancels a confirmed reservation and charges any fee due under its cancellation policy.
Send expected_fee (from the cancellation quote you showed the guest); if the fee has since risen,
the request fails with 409 cancellation-fee-changed instead of charging more.
post
https://api.konghotels.cloud/reservations/{confirmationNumber}/cancel
Path Parameters
confirmationNumberstringrequired
Example:KH4DEMO01
Headers
Idempotency-Keystring
Optional. Makes the request safe to retry for 24 hours.
<= 255 characters
Example:8e03978e-40d5-43e8-bc93-6894a57f9324
Body
application/json
Body
application/json
reasonstring | null
<= 255 characters
expected_feestring | number | null
The fee you displayed to the guest.
Response
application/json
Response
application/json
Cancelled reservation. See cancellation for the cancellation number and fee.
dataobject
Show Child Parameters
post/reservations/{confirmationNumber}/cancel
Authentication
Path Parameters
Headers
Body
{
"reason": "Guest changed travel plans",
"expected_fee": "0.00"
}
application/json