List published reviews for a vacation rental
View .mdGET /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
Section titled “Contract status”| Field | Value |
|---|---|
| Maturity | beta |
| Required capability | reviews.read |
| Freshness class | published-content |
| Quota cost | 1 |
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
Section titled “Request parameters”| Name | In | Type | Required | Description |
|---|---|---|---|---|
cursor |
query | string | no | |
limit |
query | integer | no | |
vacationRental |
path | string | yes |
Request body
Section titled “Request body”This operation has no JSON request body.
Set KISMET_API_ORIGIN=https://api.ksmt.app and configure KISMET_DEVELOPER_API_KEY in your environment. Run server-credential requests from your backend, not browser code.
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
Section titled “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. |
200 response example
Section titled “200 response 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 } }}200 response schema
Section titled “200 response schema”Content type: application/json. Required fields, nullable values, and nested structures are defined below.
View complete response schema
{ "type": "object", "additionalProperties": false, "required": [ "data", "page", "meta" ], "properties": { "data": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "id", "channel", "overallRating", "reviewText", "hostResponse", "reviewerDisplayName", "reviewDate", "categoryRatings", "personas", "features", "season" ], "properties": { "id": { "type": "string" }, "channel": { "type": "string" }, "overallRating": { "type": [ "null", "number" ] }, "reviewText": { "type": [ "null", "string" ] }, "hostResponse": { "type": [ "null", "string" ] }, "reviewerDisplayName": { "type": [ "null", "string" ] }, "reviewDate": { "type": [ "null", "string" ], "format": "date-time" }, "categoryRatings": { "type": "object", "additionalProperties": false, "required": [ "cleanliness", "accuracy", "checkin", "communication", "location", "value" ], "properties": { "cleanliness": { "type": [ "null", "number" ] }, "accuracy": { "type": [ "null", "number" ] }, "checkin": { "type": [ "null", "number" ] }, "communication": { "type": [ "null", "number" ] }, "location": { "type": [ "null", "number" ] }, "value": { "type": [ "null", "number" ] } } }, "personas": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "slug", "label", "confidence", "source" ], "properties": { "slug": { "type": "string" }, "label": { "type": "string" }, "confidence": { "type": [ "null", "number" ] }, "source": { "type": "string", "enum": [ "ai", "manual" ] } } } }, "features": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": [ "slug", "label", "confidence", "source" ], "properties": { "slug": { "type": "string" }, "label": { "type": "string" }, "confidence": { "type": [ "null", "number" ] }, "source": { "type": "string", "enum": [ "ai", "manual" ] } } } }, "season": { "anyOf": [ { "type": "null" }, { "type": "object", "additionalProperties": false, "required": [ "season", "source" ], "properties": { "season": { "type": "string" }, "source": { "type": "string", "enum": [ "derived", "ai", "manual" ] } } } ] } } } }, "page": { "type": "object", "additionalProperties": false, "required": [ "limit", "nextCursor" ], "properties": { "limit": { "type": "integer" }, "nextCursor": { "type": [ "null", "string" ] } } }, "meta": { "type": "object", "additionalProperties": false, "required": [ "aggregate" ], "properties": { "aggregate": { "type": "object", "additionalProperties": false, "required": [ "overallRating", "reviewCount" ], "properties": { "overallRating": { "type": [ "null", "number" ] }, "reviewCount": { "type": "integer" } } } } } }}