---
title: "List published reviews for a vacation rental"
description: "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."
---

`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

```sh
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

```json
{
  "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

- [This page as Markdown](/api/reference/list-vacation-rental-reviews.md)
- [Developer API OpenAPI v0.7.0](/openapi.json)