Submit a verified-stay review
Write. For one of your reservations at this property with status checked_out. One review per reservation.
post
https://api.konghotels.cloud/properties/{propertyCode}/reviews
Path Parameters
propertyCodestringrequired
Property code (case-insensitive).
Example:KTNYC
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
ReviewRequest
confirmation_numberstringrequired
overall_ratingintegerrequired
>= 1<= 10
category_ratingsobjectrequired
Show Child Parameters
titlestringrequired
<= 120 characters
bodystringrequired
>= 20 characters<= 5000 characters
reviewer_namestringrequired
Display name
<= 60 characters
traveler_typestringrequired
Allowed values:solocouplefamilybusinessfriends
languagestring
Default:en
Response
application/json
Response
application/json
Published review.
dataobject
Show Child Parameters
post/properties/{propertyCode}/reviews
Authentication
Path Parameters
Headers
Body
{
"confirmation_number": "confirmation_number",
"overall_rating": 0,
"category_ratings": {
"cleanliness": 0,
"comfort": 0,
"location": 0,
"service": 0,
"value": 0
},
"title": "title",
"body": "body",
"reviewer_name": "reviewer_name",
"traveler_type": "solo"
}
application/json
Availability
Live, fully priced availability. Uses the search rate-limit bucket.
Search availability across properties
For metasearch and listing pages. Returns the cheapest sellable offer per property for a
destination, a list of properties, or a radius (one of destination, properties or
latitude+longitude is required). Up to 50 properties are evaluated per call.
get
https://api.konghotels.cloud/availability
Query Parameters
destinationstring
Example:tokyo
propertiesstring
Comma-separated property codes.
Example:KTNYC,KBBRK
latitudenumber
longitudenumber
radius_kmnumber
Default:25
check_instring(date)required
Arrival date (property-local), today or later.
Example:2026-12-04
check_outstring(date)required
Departure date, after check_in. Maximum 30 nights.
Example:2026-12-07
adultsintegerrequired
>= 1<= 36
Example:2
childreninteger
Default:0
>= 0<= 18
roomsinteger
Rooms of the same type. 10+ rooms must be a group request.
Default:1
>= 1<= 9
max_totalnumber
Exclude properties whose cheapest total exceeds this amount (property currency).
promotion_codestring
Response
application/json
Response
application/json
Available properties.
AvailabilitySearchResponse
dataarray[object]
Show Child Parameters
metaobject
Show Child Parameters
get/availability
Authentication
Query Parameters
application/json
Get rooms and rates for a stay
Every sellable room type × rate plan for the stay, fully priced with taxes and concrete
cancellation terms. Member-only offers are included and flagged requires_membership; you need
verified loyalty details to quote them.
If promotion_code doesn’t apply, offers are returned without it and promotion.applied is
false with reasons.
get
https://api.konghotels.cloud/properties/{propertyCode}/availability
Query Parameters
check_instring(date)required
Arrival date (property-local), today or later.
Example:2026-12-04
check_outstring(date)required
Departure date, after check_in. Maximum 30 nights.
Example:2026-12-07
adultsintegerrequired
>= 1<= 36
Example:2
childreninteger
Default:0
>= 0<= 18
roomsinteger
Rooms of the same type. 10+ rooms must be a group request.
Default:1
>= 1<= 9
room_typestring
Limit to one room type code.
rate_planstring
Limit to one rate plan code.
promotion_codestring
Example:KONGWEEKEND
include_unavailableboolean
Also list unsellable room types with their restrictions.
Default:false
Path Parameters
propertyCodestringrequired
Property code (case-insensitive).
Example:KTNYC
Response
application/json
Response
application/json
Priced availability.
PropertyAvailabilityResponse
dataobject
Show Child Parameters
metaobject
Show Child Parameters
get/properties/{propertyCode}/availability
Authentication
Path Parameters
Query Parameters
application/json
Get a rate calendar
Day-by-day availability and the lowest Best Available Rate (per room per night, before taxes)
for up to 93 days, for date pickers and “flexible dates” views. Indicative only; price a real
stay with /properties/{propertyCode}/availability.
get
https://api.konghotels.cloud/properties/{propertyCode}/calendar
Query Parameters
start_datestring(date)required
end_datestring(date)required
room_typestring
Path Parameters
propertyCodestringrequired
Property code (case-insensitive).
Example:KTNYC
Response
application/json
Response
application/json
Calendar days.
dataarray[object]
Show Child Parameters
metaobject
Show Child Parameters
get/properties/{propertyCode}/calendar
Authentication
Path Parameters
Query Parameters
application/json