Create a quote
Write. Re-checks availability and every booking rule, then locks the price for
KONG_QUOTE_TTL_MINUTES (15 by default). Book it with POST /reservations.
post
https://api.konghotels.cloud/quotes
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
QuoteRequest
property_codestringrequired
room_type_codestringrequired
rate_plan_codestringrequired
check_instring(date)required
check_outstring(date)required
adultsintegerrequired
>= 1<= 36
childreninteger
Default:0
>= 0<= 18
roomsinteger
Default:1
>= 1<= 9
promotion_codestring | null
loyaltyobject | null
Required for member-only rate plans.
Show Child Parameters
add_onsarray[object]
<= 10 items
Show Child Parameters
Response
application/json
Response
application/json
Quote created.
dataobject
Show Child Parameters
post/quotes
Authentication
Headers
Body
{
"property_code": "KTNYC",
"room_type_code": "TWRK",
"rate_plan_code": "MBR",
"check_in": "2026-12-04",
"check_out": "2026-12-07",
"adults": 2,
"promotion_code": "KONGWEEKEND",
"loyalty": {
"member_number": "KR10000001",
"last_name": "Darrow"
},
"add_ons": [
{
"code": "BRKFST",
"quantity": 1
}
]
}
application/json
Get a quote
get
https://api.konghotels.cloud/quotes/{quoteId}
Path Parameters
quoteIdstringrequired
Match pattern:^qt_
Example:qt_01jbx4m6n2kz9v8c7d5e3f1g0h
Response
application/json
Response
application/json
The quote. state is open, expired or booked.
dataobject
Show Child Parameters
get/quotes/{quoteId}
Authentication
Path Parameters
application/json
Hold inventory
Write. Takes a quote’s rooms off sale for KONG_HOLD_TTL_MINUTES (15 by default) so they can’t
be sold to anyone else while your guest completes payment. The quote stays bookable for at least
as long as the hold. One active hold per quote.
post
https://api.konghotels.cloud/holds
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
quote_idstringrequired
Example:qt_01jbx4m6n2kz9v8c7d5e3f1g0h
Response
application/json
Response
application/json
Hold created.
dataobject
Show Child Parameters
post/holds
Authentication
Headers
Body
{
"quote_id": "qt_01jbx4m6n2kz9v8c7d5e3f1g0h"
}
application/json
Get a hold
get
https://api.konghotels.cloud/holds/{holdId}
Path Parameters
holdIdstringrequired
Match pattern:^hld_
Response
application/json
Response
application/json
The hold. status is active, released, converted or expired.
dataobject
Show Child Parameters
get/holds/{holdId}
Authentication
Path Parameters
application/json
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