Create a review on a booking
POST/v2/bookings/{id}/reviews
Requires your API key in the X-API-Key header.
Creates a traveler review attached to this booking (the booking id is taken from
the URL). Only the booking's reseller may post a review on it (403 otherwise).
Reviews start in PENDING status and are surfaced on the booking's review field
once accepted (auto-accepted after 24h if not moderated).
curl -X POST "https://api.turneo.co/v2/bookings/0b7f5f7e-1234-4c56-89ab-4d5e6f7a8b9c/reviews" \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"rating": 5,
"reviewText": "Great tour, amazing guide!",
"reviewerName": "Ada Lovelace",
"reviewDate": "2026-07-01",
"internalFeedback": "Guide was excellent"
}'Path parameters
idstringrequiredBooking UUID or booking code.
- Example:
0b7f5f7e-1234-4c56-89ab-4d5e6f7a8b9c
Request bodyapplication/json, required
ratingintegerrequiredStar rating, 1–5.
- Limits:
- minimum 1, maximum 5
- Example:
5
reviewTextstringPublic review text. May be blank.
- Example:
Great tour, amazing guide!
reviewerNamestringDisplay name of the reviewer.
- Example:
Ada Lovelace
reviewDatestringReview date (
YYYY-MM-DD). Defaults to the creation time.- Example:
2026-07-01
internalFeedbackstringnullablePrivate feedback for the organizer — never displayed publicly.
- Example:
Guide was excellent
Example: full
{
"rating": 5,
"reviewText": "Great tour, amazing guide!",
"reviewerName": "Ada Lovelace",
"reviewDate": "2026-07-01",
"internalFeedback": "Guide was excellent"
}Responses
201object
The created review.
idstring (uuid)Review UUID.
- Example:
8b9c0d1e-2f3a-4b4c-9d0e-1f2a3b4c5d6e
ratingintegerStar rating, 1–5.
- Example:
5
reviewTextstringnullablePublic review text.
- Example:
Great tour, amazing guide!
reviewerNamestringnullableDisplay name of the reviewer.
- Example:
Ada Lovelace
reviewDatestringnullableReview date (
YYYY-MM-DD).- Example:
2026-07-01
internalFeedbackstringnullablePrivate feedback for the organizer.
- Example:
Guide was excellent
statusstringModeration status:
PENDING,ACCEPTEDorREJECTED. New reviews start PENDING.- Allowed values:
PENDINGACCEPTEDREJECTED- Example:
PENDING
{
"id": "8b9c0d1e-2f3a-4b4c-9d0e-1f2a3b4c5d6e",
"rating": 5,
"reviewText": "Great tour, amazing guide!",
"reviewerName": "Ada Lovelace",
"reviewDate": "2026-07-01",
"internalFeedback": "Guide was excellent",
"status": "PENDING"
}Errors
- 400
Validation failed. Inspect
errors[].fieldanderrors[].code.- 401
Missing or invalid
X-API-Keyheader.- 403
The API key is valid but not allowed to perform this action on this resource.
- 404
The resource does not exist or belongs to another partner (existence is not leaked across partners).
Error body
typestringError class.
- Allowed values:
validation_errorclient_errorserver_error- Example:
validation_error
errorsobject[]Child fields
codestringMachine-readable error code.
- Example:
required
fieldstringnullableOffending field, or null/'general' for non-field errors.
- Example:
startTime
messagestringHuman-readable message.
- Example:
This field is required.
{
"type": "validation_error",
"errors": [
{
"code": "required",
"field": "startTime",
"message": "This field is required."
}
]
}