Kong Hotels - Guest Stay API
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
List service requests
get
https://stay.konghotels.cloud/stays/{confirmationNumber}/service-requests
Query Parameters
statusstring
Allowed values:openin_progresscompletedcancelled
per_pageinteger
Default:25
>= 1<= 100
cursorstring
Opaque cursor from meta.next_cursor / links.next.
Path Parameters
confirmationNumberstringrequired
Confirmation number from the Partner API reservation.
Example:KH4DEMO01
Response
application/json
Response
application/json
Requests for this stay, newest first.
dataarray[object]required
Show Child Parameters
linksobject
Show Child Parameters
metaobject
Show Child Parameters
get/stays/{confirmationNumber}/service-requests
Authentication
Path Parameters
Query Parameters
application/json
Create a service request
Write. Sends a request to the property team. Only allowed while the stay is checked_in.
post
https://stay.konghotels.cloud/stays/{confirmationNumber}/service-requests
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
ServiceRequestCreate
service_codestringrequired
Example:EXTRA_TOWELS
quantityinteger
Default:1
>= 1
notestring | null
<= 500 characters
preferred_timestring | null(date-time)
Omit for as soon as possible.
Response
application/json
Response
application/json
Request created.
dataobjectrequired
Show Child Parameters
post/stays/{confirmationNumber}/service-requests
Authentication
Path Parameters
Headers
Body
{
"service_code": "EXTRA_TOWELS"
}
application/json
Get a service request
get
https://stay.konghotels.cloud/stays/{confirmationNumber}/service-requests/{requestId}
Path Parameters
confirmationNumberstringrequired
Confirmation number from the Partner API reservation.
Example:KH4DEMO01
requestIdstringrequired
Example:sr_01J9ZK
Response
application/json
Response
application/json
The request.
dataobjectrequired
Show Child Parameters
get/stays/{confirmationNumber}/service-requests/{requestId}
Authentication
Path Parameters
application/json
Cancel a service request
Write. Possible until the request is in_progress.
post
https://stay.konghotels.cloud/stays/{confirmationNumber}/service-requests/{requestId}/cancel
Path Parameters
confirmationNumberstringrequired
Confirmation number from the Partner API reservation.
Example:KH4DEMO01
requestIdstringrequired
Example:sr_01J9ZK
Response
application/json
Response
application/json
Cancelled.
dataobjectrequired
Show Child Parameters
post/stays/{confirmationNumber}/service-requests/{requestId}/cancel
Authentication
Path Parameters
application/json