Kong Hotels Partner API

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
quote_idstringrequired

Example:qt_01jbx4m6n2kz9v8c7d5e3f1g0h

Response

application/json

Hold created.

dataobject
Show Child Parameters
post/holds

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

The hold. status is active, released, converted or expired.

dataobject
Show Child Parameters
get/holds/{holdId}
 
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

Released hold.

dataobject
Show Child Parameters
delete/holds/{holdId}
 
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

A page of reservations.

linksobject
Show Child Parameters
metaobject
Show Child Parameters
dataarray[object]
Show Child Parameters
get/reservations
 
application/json