Reviews
Product reviews and ratings — list approved reviews and submit a review
List approved reviews for a product
Authorization
ApiKeyAuth API key is automatically provided for demo requests in the playground
In: header
Path Parameters
Product URL slug
Response Body
application/json
application/json
application/json
curl -X GET "https://test.putiikkipalvelu.fi/api/storefront/v1/reviews/gold-ring"{
"averageRating": 4.5,
"reviewCount": 42,
"distribution": {
"1": 2,
"2": 1,
"3": 5,
"4": 12,
"5": 22
},
"reviews": [
{
"id": "clx123review",
"rating": 5,
"title": "Erinomainen tuote",
"body": "Nopea toimitus ja juuri kuvauksen mukainen.",
"contentHidden": false,
"verifiedPurchase": true,
"merchantReply": null,
"createdAt": "2026-06-20T15:30:00.000Z",
"reviewerName": "Matti"
}
]
}{
"error": "Error message"
}{
"error": "Error message"
}Submit a product review
Authorization
ApiKeyAuth API key is automatically provided for demo requests in the playground
In: header
Header Parameters
Customer session token. When present and valid the review is submitted as the logged-in customer, which enables the verified-purchase check and the reward code. Omit for anonymous reviews.
Request Body
application/json
Slug of the product being reviewed.
length <= 200Star rating from 1 to 5.
1 <= value <= 5Review text. Required and must be non-empty after HTML is stripped.
length <= 5000Optional short title.
length <= 200Display name for anonymous reviews. Ignored when a valid
x-session-id header is sent (logged-in reviews use the account name).
length <= 100Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://test.putiikkipalvelu.fi/api/storefront/v1/reviews" \ -H "Content-Type: application/json" \ -d '{ "slug": "gold-ring", "rating": 5, "body": "Nopea toimitus ja juuri kuvauksen mukainen." }'{
"success": true,
"review": {
"id": "clx123review",
"status": "APPROVED",
"verifiedPurchase": true
},
"reward": {
"code": "KIITOS10",
"discountType": "PERCENTAGE",
"discountValue": 10
}
}{
"error": "Error message"
}{
"error": "Error message"
}{
"error": "Error message"
}{
"error": "Error message"
}{
"error": "Error message"
}{
"error": "Error message"
}