Skip to content
Wink

Show template

GET
/api/booking/{bookingIdentifier}/review/questions
 
curl --request GET \
  --url https://api.wink.travel/api/booking/f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92/review/questions \
  --header 'Authorization: Bearer <token>' \
  --header 'Wink-Version: 2.0'

Returns the review questionnaire for the given booking, including the available questions and their answer options, scoped to the authenticated user.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
bookingIdentifier
required
string
""

Booking identifier for which to load the review questionnaire

Example 
f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92

Header Parameters

Section titled “Header Parameters ”
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Review questionnaire for the booking

Media type application/json

Template presented to a guest when they begin writing a review, containing all questions they must answer.

object
bookingIdentifier
required

Booking identifier to review.

string format: uuid
""
hotelIdentifier
required

Property (hotel) identifier to review.

string format: uuid
""
hotelName
required

Property name for display in the review interface.

string
""
userIdentifier
required

Guest user identifier submitting the review.

string format: uuid
""
questions
required
Array<object>
>= 1 items <= 2147483647 items

Review questions for the guest to answer.

object
identifier

Unique identifier for this review question.

string format: uuid
""
category

Category of this review question (e.g., COMFORT, SERVICE, VALUE).

string
""
Allowed values: COMFORT CONDITION SERVICE ENVIRONMENT FACILITIES LOCATION LIFESTYLE VALUE FOOD ROOM
sort

Display order of this question within the review template.

integer format: int32
""
options

Available answer options for this multiple-choice question.

Array<object>

A selectable answer option for a multiple-choice review question, each carrying a numeric value.

object
sort
required

Display order of this answer option.

integer format: int32
""
value
required

Numeric value for this answer option.

integer format: int32
""
key
additional properties
""
Example 
{
  "bookingIdentifier": "f4d1c8e5-2b9a-4f3d-9e7c-1b6a5d3f8c92",
  "hotelIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18",
  "hotelName": "The Siam Residences, Bangkok",
  "userIdentifier": "c3a9f2e1-8b4d-4c7a-a1e2-5f0b6d9e2c84",
  "questions": [
    {
      "identifier": "4d7c2a6b-9e3f-4b1a-8d0c-7f5e1a9b3c62",
      "category": "SERVICE",
      "sort": 1,
      "options": [
        {
          "sort": 1,
          "value": 2
        },
        {
          "sort": 2,
          "value": 7
        },
        {
          "sort": 3,
          "value": 10
        }
      ]
    }
  ]
}

400

Section titled “400 ”

Bad Request — missing or invalid request parameter or body

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

401

Section titled “401 ”

Unauthorized — authentication is required or the session has expired

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

403

Section titled “403 ”

Forbidden — authenticated but lacking the required permission or scope

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

404

Section titled “404 ”

Not Found — the requested resource does not exist

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

405

Section titled “405 ”

Method Not Allowed — the HTTP verb is not supported on this endpoint

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

415

Section titled “415 ”

Unsupported Media Type — use application/json

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

500

Section titled “500 ”

Internal Server Error — an unexpected failure occurred on the server

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

503

Section titled “503 ”

Service Unavailable — a downstream dependency is unreachable

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example