Reviews
Get reviews for a specific listing
Retrieves all reviews for a listing, sorted by provider creation date (newest first)
Authorization
x-calry-api-key x-calry-api-key<token>
In: header
Path Parameters
listingId*string
Listing ID from database
Query Parameters
limit?number
Number of reviews per page
Default
20Range
1 <= value <= 100page?number
Page number
Default
1Range
1 <= valuesearch?string
Search term to filter reviews
Header Parameters
x-calry-workspace-id?string
Optional workspace ID to specify which workspace to operate as. If not provided, the default workspace will be used.
x-calry-tenant-id?string
Optional tenant ID to specify which tenant to operate as. If not provided, the default tenant will be used.
Response Body
application/json
application/json
curl -X GET "https://example.com/api/v1/reviews/listing/a1b2c3d4-e5f6-7890-abcd-ef1234567890"{
"data": [
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"providerReviewID": "hostify_review_123",
"providerListingID": "hostify_listing_456",
"providerReservationID": "hostify_reservation_789",
"guest": {
"fullName": "John Doe",
"firstName": "John",
"lastName": "Doe"
},
"title": "Amazing stay!",
"content": "We had a wonderful time at this property. Everything was clean and well-maintained.",
"feedback": "Host was very responsive and helpful.",
"rating": 4.8,
"ratingCategories": {
"cleanliness": {
"rating": 5,
"comment": "Spotless!"
},
"communication": {
"rating": 5,
"comment": "Very responsive"
}
},
"hostResponse": {
"content": "Thank you for the wonderful review!",
"createdAt": "2023-12-01T10:00:00Z"
},
"language": "en",
"providerCreatedAt": "2023-11-15T14:30:00Z",
"providerUpdatedAt": "2023-11-16T09:15:00Z",
"createdAt": "2023-11-15T14:35:00Z",
"updatedAt": "2023-11-16T09:20:00Z"
}
],
"meta": {
"total": 100,
"limit": 15,
"totalPages": 8,
"current": 2,
"previous": 1,
"next": 3
}
}{
"timestamp": "2025-03-05T11:45:49.631Z",
"path": "<URL_PATH>",
"message": "Authentication failed",
"details": []
}Empty