Submit
const url = 'https://api.wink.travel/api/booking/f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92/review';const options = { method: 'POST', 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 POST \ --url https://api.wink.travel/api/booking/f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92/review \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data nullSubmits the authenticated guest’s completed review for the given booking and returns the persisted review. Responds 201 on success.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Booking identifier for which the review is being submitted
Example
f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92Header Parameters
Section titled “Header Parameters ”Request Body required
Section titled “Request Body required ”Completed review containing the guest’s answers to the questionnaire questions
Request payload submitted by a guest to record their review for a completed stay.
object
List of user review answers.
A single answer submitted by a guest for one review question, carrying the question reference and numeric score.
object
Review question identifier that this answer responds to.
Example
4d7c2a6b-9e3f-4b1a-8d0c-7f5e1a9b3c62Category of the question (e.g., COMFORT, SERVICE, VALUE).
Example
SERVICEDisplay order of this answer within the review template.
Example
1Guest’s numeric rating for this question on a 0-10 scale.
Example
7Example
{ "questionIdentifier": "4d7c2a6b-9e3f-4b1a-8d0c-7f5e1a9b3c62", "category": "SERVICE", "sort": 1, "value": 7}Private message from guest to the hotel manager. Not displayed on property’s public profile.
Example
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.Cloudinary image identifier for guest’s photo from the property.
Example
wink/review/siam-residences-2026-01-14-xyz123abcGuest’s written review text describing their stay.
Example
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.Room number where the guest stayed.
Example
501Guest’s personal rating of their room on a 0-10 scale.
Example
9Example
{ "answers": [ { "questionIdentifier": "4d7c2a6b-9e3f-4b1a-8d0c-7f5e1a9b3c62", "category": "SERVICE", "sort": 1, "value": 7 } ], "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.", "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.", "roomNumber": "501", "roomRating": 9}Responses
Section titled “ Responses ”Review submitted and persisted
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
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