Kong Hotels - Guest Stay API
Check in online
Write. Completes online check-in from 72 hours before arrival. The guest is told when their room is ready, and mobile keys can be issued from that point.
post
https://stay.konghotels.cloud/stays/{confirmationNumber}/check-in
Path Parameters
confirmationNumberstringrequired
Confirmation number from the Partner API reservation.
Example:KH4DEMO01
Headers
Idempotency-Keystring
Optional. Makes the request safe to retry for 24 hours.
<= 255 characters
Body
application/json
Body
application/json
CheckInRequest
estimated_arrival_timestringrequired
Match pattern:^\d{2}:\d{2}$
Example:16:30
accept_termsbooleanrequired
Guest accepts the house policies.
room_preferencesarray[string]
Allowed values:high_floorlow_floorquietnear_elevatoraccessible
special_requestsstring | null
<= 500 characters
Response
application/json
Response
application/json
Checked in. Returns the updated stay.
dataobjectrequired
Show Child Parameters
post/stays/{confirmationNumber}/check-in
Authentication
Path Parameters
Headers
Body
{
"estimated_arrival_time": "16:30",
"accept_terms": false
}
application/json
Check out
Write. Express check-out. The folio is settled with the payment on file and a receipt is emailed to the guest. Mobile keys are revoked.
post
https://stay.konghotels.cloud/stays/{confirmationNumber}/check-out
Path Parameters
confirmationNumberstringrequired
Confirmation number from the Partner API reservation.
Example:KH4DEMO01
Headers
Idempotency-Keystring
Optional. Makes the request safe to retry for 24 hours.
<= 255 characters
Body
application/json
Body
application/json
CheckOutRequest
receipt_emailstring | null(email)
Defaults to the email on the reservation.
feedback_scoreinteger | null
>= 1<= 5
Response
application/json
Response
application/json
Checked out. Returns the updated stay.
dataobjectrequired
Show Child Parameters
post/stays/{confirmationNumber}/check-out
Authentication
Path Parameters
Headers
Body
{}
application/json
Request late check-out
Write. Asks the front desk for a later departure time. Approval depends on the next day’s occupancy, so the request starts as pending.
post
https://stay.konghotels.cloud/stays/{confirmationNumber}/late-check-out
Path Parameters
confirmationNumberstringrequired
Confirmation number from the Partner API reservation.
Example:KH4DEMO01
Headers
Idempotency-Keystring
Optional. Makes the request safe to retry for 24 hours.
<= 255 characters
Body
application/json
Body
application/json
LateCheckOutRequest
requested_timestringrequired
Match pattern:^\d{2}:\d{2}$
Example:14:00
Response
application/json
Response
application/json
Request recorded.
dataobjectrequired
Show Child Parameters
post/stays/{confirmationNumber}/late-check-out
Authentication
Path Parameters
Headers
Body
{
"requested_time": "14:00"
}
application/json
Mobile Keys
Digital room keys for guest phones.
List mobile keys
get
https://stay.konghotels.cloud/stays/{confirmationNumber}/keys
Path Parameters
confirmationNumberstringrequired
Confirmation number from the Partner API reservation.
Example:KH4DEMO01
Response
application/json
Response
application/json
Keys issued for this stay.
dataarray[object]required
Show Child Parameters
get/stays/{confirmationNumber}/keys
Authentication
Path Parameters
application/json