Kong Hotels Partner API

Reviews

Guest reviews and verified-stay submissions.

List reviews

Published guest reviews (1–10 scale) with a score summary in meta.summary.

get
https://api.konghotels.cloud/properties/{propertyCode}/reviews

Query Parameters

traveler_typestring

Allowed values:solocouplefamilybusinessfriends

min_ratinginteger

>= 1<= 10

languagestring

Example:en

sortstring

Allowed values:newesthighestlowest

Default:newest

per_pageinteger

Default:10

>= 1<= 50

cursorstring

Opaque cursor from meta.next_cursor / links.next.

Path Parameters

propertyCodestringrequired

Property code (case-insensitive).

Example:KTNYC

Response

application/json

A page of reviews.

linksobject
Show Child Parameters
metaobject
Show Child Parameters
dataarray[object]
Show Child Parameters
get/properties/{propertyCode}/reviews
 
application/json

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

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

Published review.

dataobject
Show Child Parameters
post/properties/{propertyCode}/reviews

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

Available properties.

AvailabilitySearchResponse

dataarray[object]
Show Child Parameters
metaobject
Show Child Parameters
get/availability
 
application/json