Kong Hotels Partner API

Get a rate plan

get
https://api.konghotels.cloud/properties/{propertyCode}/rate-plans/{ratePlanCode}

Path Parameters

propertyCodestringrequired

Property code (case-insensitive).

Example:KTNYC

ratePlanCodestringrequired

Example:BAR

Response

application/json

The rate plan.

dataobject
Show Child Parameters
get/properties/{propertyCode}/rate-plans/{ratePlanCode}
 
application/json

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.