Review API

This Review API is only supported for Booking.com only.

Use the correct OTA code for implementation: Booking.com Channel ID = 19.

Review is the way to share your stay experience with others, and it can be used not only by future travelers but also by competing hotels to see what others are saying about them so that they may improve their services.

People are more likely to book a room in a hotel that has a large number of reviews. They always keen to get an idea of what the experience will be like before actually booking it.

For hoteliers, positive reviews and the customer satisfaction are most important factors because they can encourage the business.

Su Review API allows delivery of guest reviews to property.
Reviews only shared for guests with booking.
API applicable for supported channel(s).

Retrieve Review

The reviews received from OTA are delivered to partner by post method. Reviews are posted to an endpoint provided by partner. Please note reviews can only be delivered to a single dedicated endpoint. Upon receipt, partners will need to filter reviews based on property ID.

Endpoint

Please provide endpoint for reviews delivery. 

Authorization String: Partner has to provide Authorization credentials.

Attributes

hotel_id alphanumeric

Specifies the hotel ID for the property.

channel_id string

The identifier of the connected channel (e.g., Agoda, Booking.com).

channel_property_id string

Specifies the channel-specific hotel ID

channel_review_id string

Specifies the channel-specific review for the property.

review_title string

Specifies the title of review for the property.

review_description string

Specifies the description for the review.

review_negative_description string

Specifies the negative description for the review.

review_score object

An object containing the rating scores given by the guest.

cleanliness integer

Rating for cleanliness (scale typically 1–5).

location integer

Rating for location (scale typically 1–5).

overall integer

Overall rating score (scale can vary, e.g., 1–100).

review_type string

Specifies the type of review.

review_status string

Indicates the status of the review.

Possible values: "published", "created", "in_review".

review_date string

The date when the review was created. Format: YYYY-MM-DD.

is_eligible_to_respond boolean

Indicates whether the host is allowed to respond to the review.

reviewee_name string

The name of the host being reviewed.

Sample Request

{
  "hotel_id": "AWSTEST",
  "channel_id": "19",
  "channel_property_id": "123456",
  "channel_review_id": "19_HJDHDH",
  "review_title": "Great stay!",
  "review_description": "Loved the location and service.",
  "review_negative_description": "Room was a bit small.",
  "review_score": {
    "cleanliness": 5,
    "location": 5,
    "overall": 55
  },
  "review_type": "guest_to_host",
  "review_status": "published / created / in_review",
  "review_date": "2025-01-01",
  "is_eligible_to_respond": true,
  "reviewee_name": "Vishal Potter"
}

Response

Sample Success Response

{
"status": "Success"
}

Response Body Element

Status string

Indicates the result of the API call.

Will be "Success" for successful operations.

Will be always "Fail" in case of an error response.

Review Reply

Partners can reply to guest reviews on the supported channel, i.e., Booking.com.

Endpoint

POST

https://connect-sandbox.su-api.com/SUAPI/jservice/review/reply

Attributes

hotel_id alphanumeric (Required)

Specifies the hotel ID for the property.

channel_id alphanumeric (Required)

Identifier of the distribution channel (OTA).

channel_property_id alphanumeric (Required)

Specifies the channel-specific hotel ID.

channel_review_id string (Required)

Specifies the channel-specific review ID

review_reply string (Required)

Specifies the reply from the partner for the review.

Sample Request

{
  "hotel_id": "Test256",
  "channel_id": "19",
  "channel_property_id": "12837615",
  "channel_review_id": "19_xyz",
  "review_reply": "Thank you for your feedback!"
}

Response

Sample Success Response

{
  "Status": "Success",
  "Warnings": [],
  "Errors": [],
  "Message": "Review replied successfully",
  "Ruid": ""
}

Sample Error Response

{
  "Errors": {
    "Code": "558",
    "ShortText": "hotel_id: Invalid HotelCode (MEE1)"
  },
  "Status": "Fail"
}

{
  "Errors": {
    "Code": "947",
    "ShortText": "Property is inactive"
  },
  "Status": "Fail"
}

{
  "Errors": {
    "Code": "573",
    "ShortText": "channel-mapping not found for this property!"
  },
  "Status": "Fail"
}

{
  "Status": "Fail",
  "Errors": [],
  "Message": "",
  "Ruid": "e527c45a-f23a-4ee4-beb2-7d21f7699b1",
}

Response Body Element

Status string

Indicates the result of the API call.

Will be "Success" for successful operations.

Will be always "Fail" in case of an error response.

Data object

The response data, the root element.

Message string

The message in the response.

Code string

Specific error code that helps identify the type of error.

ShortText string

A short description of the error.

Indicates channel room id and rate id.

Status string

Indicates the result of the API call.

Will be "Success" for successful operations.

PreviousReview API (Soon to be Deprecated)NextMessaging

Last updated 16 days ago

Was this helpful?