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
Promotions
Promotion codes and their eligibility rules.
List public promotions
Public promotions bookable today. Private codes (closed user groups) are not listed but can be looked up.
get
https://api.konghotels.cloud/promotions
Query Parameters
propertystring
Only promotions valid at this property.
Response
200 application/json
Response
200 application/json
Promotions.
dataarray[object]
Show Child Parameters
get/promotions
Authentication
Query Parameters
200 application/json