Review summary over the caller's bookings
GET/v2/bookings/summary
Requires your API key in the X-API-Key header.
Aggregates review statistics over the bookings visible to the caller (after
applying any list-endpoint filters passed in the query string): the average
review rating (rounded to 2 decimals) and the review count. By default only
ACCEPTED reviews are counted; pass unapprovedReviews (any truthy value) to
include pending/rejected reviews too.
curl "https://api.turneo.co/v2/bookings/summary" \
-H "X-API-Key: <your-api-key>"Query parameters
unapprovedReviewsbooleanWhen present, includes reviews of every moderation status instead of only ACCEPTED ones.
- Example:
true
Responses
200object
Aggregated review stats.
avgReviewScorenumbernullableAverage review rating rounded to 2 decimals. Null when there are no matching reviews.
- Example:
4.67
reviewsCountintegerNumber of reviews counted (ACCEPTED only, unless
unapprovedReviewsis passed).- Example:
12
{
"avgReviewScore": 4.67,
"reviewsCount": 12
}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.
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."
}
]
}