List published reviews for a vacation rental

GET /v1/developer/vacation-rentals/{vacationRental}/reviews

Operation ID: listVacationRentalReviews

Returns published, non-transactional Kismet content within the authenticated application grant. No rates, availability, indicative pricing, booking URL, draft state, or vendor payload is returned.

Contract status

Field	Value
Maturity	`beta`
Required capability	`reviews.read`
Freshness class	`published-content`
Quota cost	`1`
Operational owner	API + Developer Experience

All operations require a Kismet Developer Bearer credential. Collection and resource authority is resolved from the credential’s installation grants; identifiers in the URL never grant access.

Request parameters

Name	In	Type	Required	Description
`cursor`	query	string	no
`limit`	query	integer	no
`vacationRental`	path	string	yes

Request body

This operation has no JSON request body.

cURL

curl --request GET \
  "$KISMET_API_ORIGIN/v1/developer/vacation-rentals/sand-sea-110/reviews" \
  --header "Authorization: Bearer $KISMET_DEVELOPER_API_KEY" \
  --header "Accept: application/json"

Responses

Status	Meaning
200	Success.
400	Invalid request parameters or body.
401	Missing, invalid, expired, or inappropriate credential/session.
403	Credential lacks the required grant/capability, or an origin/CSRF check failed.
429	Rate limit or quota exceeded; inspect response metadata before retrying.
503	A required Kismet dependency is temporarily unavailable.

Success example

{
  "data": [
    {
      "id": "44444444-4444-4444-8444-444444444444",
      "channel": "airbnb",
      "overallRating": 5,
      "reviewText": "Wonderful stay — spotless and quiet.",
      "hostResponse": "Thank you! Come back any time.",
      "reviewerDisplayName": "Jamie",
      "reviewDate": "2026-05-20T00:00:00.000Z",
      "categoryRatings": {
        "cleanliness": 5,
        "accuracy": 5,
        "checkin": 5,
        "communication": 5,
        "location": 4.5,
        "value": 5
      },
      "personas": [
        {
          "slug": "family",
          "label": "Family",
          "confidence": 0.92,
          "source": "ai"
        }
      ],
      "features": [
        {
          "slug": "amazing-host",
          "label": "Amazing host",
          "confidence": 0.88,
          "source": "ai"
        }
      ],
      "season": {
        "season": "spring",
        "source": "derived"
      }
    }
  ],
  "page": {
    "limit": 20,
    "nextCursor": null
  },
  "meta": {
    "aggregate": {
      "overallRating": 4.9,
      "reviewCount": 24
    }
  }
}

Machine-readable sources