Release a hold
Write. Returns the held rooms to inventory immediately. Do this when a guest abandons checkout.
delete
https://api.konghotels.cloud/holds/{holdId}
Path Parameters
holdIdstringrequired
Match pattern:^hld_
Response
application/json
Response
application/json
Released hold.
dataobject
Show Child Parameters
delete/holds/{holdId}
Authentication
Path Parameters
application/json
Reservations
Book, retrieve, modify and cancel stays.
List reservations
Your organisation’s reservations, newest first. Use updated_since for reconciliation.
get
https://api.konghotels.cloud/reservations
Query Parameters
partner_referencestring
Your own booking reference.
propertystring
statusstring
Allowed values:confirmedchecked_inchecked_outcancelledno_show
check_in_fromstring(date)
check_in_tostring(date)
updated_sincestring(date-time)
per_pageinteger
>= 1<= 100
cursorstring
Opaque cursor from meta.next_cursor / links.next.
Response
application/json
Response
application/json
A page of reservations.
linksobject
Show Child Parameters
metaobject
Show Child Parameters
dataarray[object]
Show Child Parameters
get/reservations
Authentication
Query Parameters
application/json
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