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).

Requestbash
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

  • idstringrequired

    Booking UUID or booking code.

    Example:
    0b7f5f7e-1234-4c56-89ab-4d5e6f7a8b9c

Request bodyapplication/json, required

  • ratingintegerrequired

    Star rating, 1–5.

    Limits:
    minimum 1, maximum 5
    Example:
    5
  • reviewTextstring

    Public review text. May be blank.

    Example:
    Great tour, amazing guide!
  • reviewerNamestring

    Display name of the reviewer.

    Example:
    Ada Lovelace
  • reviewDatestring

    Review date (YYYY-MM-DD). Defaults to the creation time.

    Example:
    2026-07-01
  • internalFeedbackstringnullable

    Private feedback for the organizer — never displayed publicly.

    Example:
    Guide was excellent
Example: full
fulljson
{
  "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
  • ratinginteger

    Star rating, 1–5.

    Example:
    5
  • reviewTextstringnullable

    Public review text.

    Example:
    Great tour, amazing guide!
  • reviewerNamestringnullable

    Display name of the reviewer.

    Example:
    Ada Lovelace
  • reviewDatestringnullable

    Review date (YYYY-MM-DD).

    Example:
    2026-07-01
  • internalFeedbackstringnullable

    Private feedback for the organizer.

    Example:
    Guide was excellent
  • statusstring

    Moderation status: PENDING, ACCEPTED or REJECTED. New reviews start PENDING.

    Allowed values:
    PENDINGACCEPTEDREJECTED
    Example:
    PENDING
Response 201json
{
  "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[].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.

404

The resource does not exist or belongs to another partner (existence is not leaked across partners).

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."
    }
  ]
}