Skip to main content

​
Create Review

curl -X POST https://api.kinconecta.com/api/reviews \
  -H "Content-Type: application/json" \
  -d '{
    "tripId": 123,
    "tourId": 456,
    "guideId": 789,
    "touristId": 101,
    "rating": 5,
    "comment": "Amazing tour! The guide was very knowledgeable and friendly.",
    "likesCount": 0,
    "repliesCount": 0
  }'
Create a new review for a tour.

​
Request Body

​
tripId
integer
required
ID of the trip booking being reviewed
​
tourId
integer
required
ID of the tour being reviewed
​
guideId
integer
required
ID of the guide being reviewed
​
touristId
integer
required
ID of the tourist submitting the review
​
rating
integer
required
Rating from 1 to 5 stars
​
comment
string
Review comment text
​
likesCount
integer
Number of likes (default: 0)
​
repliesCount
integer
Number of replies (default: 0)

​
Response

​
reviewId
integer
Unique identifier for the review
​
tripId
integer
ID of the trip booking
​
tourId
integer
ID of the tour
​
guideId
integer
ID of the guide
​
touristId
integer
ID of the tourist
​
rating
integer
Rating value (1-5)
​
comment
string
Review comment
​
likesCount
integer
Number of likes
​
repliesCount
integer
Number of replies
​
createdAt
datetime
Timestamp when the review was created
​
updatedAt
datetime
Timestamp when the review was last updated
​
deletedAt
datetime
Timestamp when the review was deleted (if applicable)

​
Get All Reviews

curl https://api.kinconecta.com/api/reviews
Retrieve all reviews in the system.

​
Response

Returns an array of review objects with the same structure as the create review response.

​
Get Review by ID

curl https://api.kinconecta.com/api/reviews/123
Retrieve a specific review by its ID.

​
Path Parameters

​
id
integer
required
The review ID

​
Response

Returns a single review object.

​
Update Review

curl -X PUT https://api.kinconecta.com/api/reviews/123 \
  -H "Content-Type: application/json" \
  -d '{
    "rating": 5,
    "comment": "Updated review: Absolutely amazing experience!"
  }'
Update an existing review.

​
Path Parameters

​
id
integer
required
The review ID

​
Request Body

All fields from the create request are optional. Only provide the fields you want to update.
​
rating
integer
Updated rating (1-5)
​
comment
string
Updated comment text

​
Response

Returns the updated review object.

​
Delete Review

curl -X DELETE https://api.kinconecta.com/api/reviews/123
Delete a review by its ID.

​
Path Parameters

​
id
integer
required
The review ID

​
Response

Returns 204 No Content on successful deletion.

Build docs developers (and LLMs) love

Get started for freeTalk to us