Accommodation Reviews

Guest reviews of their experience at the accommodation

Schema

created_at
string

The ISO 8601 date at which the review was submitted.

Example: "2025-01-01"
reviewer_name
string

The name of the guest who submitted the review. When the name is unknown, the name will be Anonymous.

Example: "Bessie Coleman"
score
number

The reviewers score of this accommodation. If available, the value is a score from the 1.0-10.0 range.

Example: 8.4
text
string

The review statement submitted by the traveller.

Example: "Excellent facilities. Polite staff.\nAir conditioning could use some maintenance.\n"

Get accommodation reviews

Preview

This is not yet finalised. It may change, or be removed or be not yet accessible.

Gets reviews for an accommodation

URL parameters

id
stringrequired

The unique ID for the accommodation to get reviews for.

Example: "acc_0000AWr2VsUNIF1Vl91xg0"

Query parameters

after
string

A cursor pointing to the previous page of records. For more information on how to paginate through records, see the Pagination section.

Example: "g2wAAAACbQAAABBBZXJvbWlzdC1LaGFya2l2bQAAAB="
before
string

A cursor pointing to the next page of records. For more information on how to paginate through records, see the Pagination section.

Example: "g2wAAAACbQAAABBBZXJvbWlzdC1LaGFya2l2bQAAAB="
limit
integer

The maximum number of records to return per page. Defaults to 50. May be set to any integer between 1 and 200. For more information on how to paginate through records, see the Pagination section.

Example: 1
Default value: 50

Preview

This is not yet finalised. It may change, or be removed or be not yet accessible.

Endpoint

GET https://api.duffel.com/stays/accommodation/{id}/reviews

Request

curl -X GET --compressed "https://api.duffel.com/stays/accommodation/{id}/reviews?after=g2wAAAACbQAAABBBZXJvbWlzdC1LaGFya2l2bQAAAB=&before=g2wAAAACbQAAABBBZXJvbWlzdC1LaGFya2l2bQAAAB=&limit=1" \
  -H "Accept-Encoding: gzip" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Duffel-Version: v2" \
  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>"

Response

{
  "meta": {
    "limit": 50,
    "after": "g2wAAAACbQAAABBBZXJvbWlzdC1LaGFya2l2bQAAAB="
  },
  "data": {
    "reviews": [
      {
        "text": "Excellent facilities. Polite staff.\nAir conditioning could use some maintenance.\n",
        "score": 8.4,
        "reviewer_name": "Bessie Coleman",
        "created_at": "2025-01-01"
      }
    ]
  }
}