Respond to review
const url = 'https://api.wink.travel/api/managing-entity/e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18/extranet/review/4d7c2a6b-9e3f-4b1a-8d0c-7f5e1a9b3c62/response';const options = { method: 'PATCH', headers: { 'Wink-Version': '2.0', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: 'null'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PATCH \ --url https://api.wink.travel/api/managing-entity/e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18/extranet/review/4d7c2a6b-9e3f-4b1a-8d0c-7f5e1a9b3c62/response \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data nullLets a hotelier post a public reply to a guest review for the given managing entity, attributing the response to the authenticated user.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Respond to review for property with this identifier
Example
e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18Respond to review with this identifier
Example
4d7c2a6b-9e3f-4b1a-8d0c-7f5e1a9b3c62Header Parameters
Section titled “Header Parameters ”Request Body required
Section titled “Request Body required ”The hotelier’s public response text
Hotel manager’s response to a guest review, including approval decisions for public display of the review text and uploaded photo.
object
Textual response from hotel to guest’s review.
Example
Thank you so much for taking the time to share such wonderful feedback about your stay at The Siam Residences. We're delighted that you and your husband had such a memorable experience. We look forward to welcoming you back soon!Property approves the use of guest review text with property profile.
Example
trueProperty approves the use of guest-generated image with property profile.
Example
trueExample
{ "responseFromHotel": "Thank you so much for taking the time to share such wonderful feedback about your stay at The Siam Residences. We're delighted that you and your husband had such a memorable experience. We look forward to welcoming you back soon!", "approvedText": true, "approvedImage": true}Responses
Section titled “ Responses ”Review response saved and published
Persisted guest review document recording a traveler’s experience at a property after checkout.
object
Document UUID
Datetime this record was first created
Datetime this record was last updated
Version property that shows how many times this document has been persisted. Document will not persist if the version property is less than current version property in the system. Result in an optimistic locking exception.
Booking identifier this review is associated with.
Property (hotel) identifier this review is for.
Guest who submitted the review.
object
User identifier
Guest’s first name.
Guest’s last name.
Guest’s email address.
Guest’s phone number.
Guest’s full name.
Date and time the review was submitted.
Average rating across all question answers (0-10 scale).
Guest’s answers to each review question with their scores.
A guest’s recorded answer to a single review question, including the score and question metadata.
object
Review question identifier that this answer responds to.
Category of the question (e.g., COMFORT, SERVICE, VALUE).
Display order of this answer within the review.
Guest’s numeric rating for this question on a 0-10 scale.
Private feedback message from guest to hotel manager. Not publicly displayed.
Hotel’s public response to the guest review.
Cloudinary image identifier for guest’s photo from their stay.
Guest’s written review text.
Hotel has approved this review text for public display on their profile.
Hotel has approved the guest’s photo for public display on their profile.
User identifiers who ‘liked’ this review.
Guest’s room number during their stay.
Guest’s personal rating of their room on a 0-10 scale.
Hotel has submitted a response to this review.
Example
{ "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47", "createdDate": "2026-01-14T09:30:00", "lastUpdate": "2026-02-03T16:45:12", "version": 3, "bookingIdentifier": "f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92", "hotelIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "user": { "userIdentifier": "c3a9f2e1-8b4d-4c7a-a1e2-5f0b6d9e2c84", "firstName": "Alexandra", "lastName": "Beaumont", "telephone": "+66 2 126 8866", "fullName": "Alexandra Beaumont" }, "reviewDate": "2026-01-20T11:00:00", "averageScore": 8.7, "answers": [ { "questionIdentifier": "4d7c2a6b-9e3f-4b1a-8d0c-7f5e1a9b3c62", "category": "SERVICE", "sort": 1, "value": 9 }, { "questionIdentifier": "5e8d3b7a-2f1c-4a9e-b6d0-8c4f2b0e7a15", "category": "COMFORT", "sort": 2, "value": 8 } ], "messageFromGuest": "Dear GM, I would like to say thank you so much for taking the time to show my husband and me around the premises and the secret cave behind the property.", "responseFromHotel": "Thank you so much for taking the time to share such wonderful feedback about your stay at The Siam Residences. We're delighted that you and your husband had such a memorable experience. We look forward to welcoming you back soon!", "imageIdentifier": "wink/review/siam-residences-2026-01-14-xyz123abc", "text": "Our stay was amazing! The staff made us feel truly welcomed, and the traditional Thai breakfast was exceptional. Can recommend highly to all. Felt like home.", "approvedText": true, "approvedImage": false, "likes": [ "c3a9f2e1-8b4d-4c7a-a1e2-5f0b6d9e2c84" ], "roomNumber": "501", "roomRating": 9, "responded": true}Bad Request — missing or invalid request parameter or body
object
object
Example
Unauthorized — authentication is required or the session has expired
object
object
Example
Forbidden — authenticated but lacking the required permission or scope
object
object
Example
Not Found — the requested resource does not exist
object
object
Example
Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Example
Unsupported Media Type — use application/json
object
object
Example
Internal Server Error — an unexpected failure occurred on the server
object
object
Example
Service Unavailable — a downstream dependency is unreachable