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.

Requestbash
curl "https://api.turneo.co/v2/bookings/summary" \
  -H "X-API-Key: <your-api-key>"

Query parameters

  • unapprovedReviewsboolean

    When present, includes reviews of every moderation status instead of only ACCEPTED ones.

    Example:
    true

Responses

200object

Aggregated review stats.

  • avgReviewScorenumbernullable

    Average review rating rounded to 2 decimals. Null when there are no matching reviews.

    Example:
    4.67
  • reviewsCountinteger

    Number of reviews counted (ACCEPTED only, unless unapprovedReviews is passed).

    Example:
    12
Response 200json
{
  "avgReviewScore": 4.67,
  "reviewsCount": 12
}

Errors

400

Validation failed. Inspect errors[].field and errors[].code.

401

Missing or invalid X-API-Key header.

403

The API key is valid but not allowed to perform this action on this resource.

Error body
  • typestring

    Error class.

    Allowed values:
    validation_errorclient_errorserver_error
    Example:
    validation_error
  • errorsobject[]
    Child fields
    • codestring

      Machine-readable error code.

      Example:
      required
    • fieldstringnullable

      Offending field, or null/'general' for non-field errors.

      Example:
      startTime
    • messagestring

      Human-readable message.

      Example:
      This field is required.
Response 400json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}