Kong Hotels - Guest Stay API
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
Issue a mobile key
Write. Issues a key to one device. Only available once the stay is checked_in and a room is assigned. Up to 4 active keys per stay.
post
https://stay.konghotels.cloud/stays/{confirmationNumber}/keys
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
MobileKeyRequest
device_idstringrequired
Stable identifier for the guest’s device.
<= 128 characters
platformstringrequired
Allowed values:iosandroid
guest_namestring | null
Shown on the key, e.g. for a second guest in the room.
<= 100 characters
Response
application/json
Response
application/json
Key issued.
dataobjectrequired
Show Child Parameters
post/stays/{confirmationNumber}/keys
Authentication
Path Parameters
Headers
Body
{
"device_id": "device_id",
"platform": "ios"
}
application/json
Revoke a mobile key
Write. Use when a guest loses or replaces their phone.
delete
https://stay.konghotels.cloud/stays/{confirmationNumber}/keys/{keyId}
Path Parameters
confirmationNumberstringrequired
Confirmation number from the Partner API reservation.
Example:KH4DEMO01
keyIdstringrequired
Example:key_7Hq2mX
Response
Response
Revoked.
delete/stays/{confirmationNumber}/keys/{keyId}
Authentication
Path Parameters
Service Requests
Free in-stay requests to the property team: housekeeping, amenities, maintenance and concierge.
List requestable services
What guests at this property can ask for during a stay, such as extra towels or a maintenance visit. These are free operational requests. Paid extras sold with a booking are add-ons in the Partner API.
get
https://stay.konghotels.cloud/properties/{propertyCode}/services
Query Parameters
categorystring
Allowed values:housekeepingamenitiesmaintenanceconcierge
Path Parameters
propertyCodestringrequired
Property code (case-insensitive), as in the Partner API.
Example:KTNYC
Response
application/json
Response
application/json
The service catalogue.
dataarray[object]required
Show Child Parameters
get/properties/{propertyCode}/services
Authentication
Path Parameters
Query Parameters
application/json