Skip to content

Get Customer Review

Retrieve detailed information for a specific product review submitted by the authenticated customer. Customers can only access their own reviews.

Endpoint

GET /api/shop/customer-reviews/{id}

Request Headers

HeaderRequiredDescription
Content-TypeYesapplication/json
X-STOREFRONT-KEYYesYour storefront API key
AuthorizationYesBearer token (customer login required)

Path Parameters

ParameterTypeRequiredDescription
idintegerYesCustomer review ID

Response Fields (200 OK)

FieldTypeDescription
idintegerReview ID
titlestringReview title
commentstringReview body text
ratingintegerStar rating (1–5)
statusstringReview status: pending, approved, or rejected
namestringReviewer display name
productobjectAssociated product (nested resource)
customerobjectCustomer who wrote the review (nested resource)
createdAtstringISO 8601 creation timestamp
updatedAtstringISO 8601 last update timestamp

Error Responses

StatusErrorDescription
401UnauthenticatedMissing or invalid Bearer token
404Not FoundCustomer review with ID "999" not found — review doesn't exist or doesn't belong to the customer

Error — Not Found (404):

json
{
  "message": "Customer review with ID \"999\" not found"
}

Error — Unauthenticated (401):

json
{
  "message": "Unauthenticated. Please login to perform this action"
}

Use Cases

  • Display individual review details
  • Show review with full context in account dashboard
  • Load specific review for viewing status
  • Check approval status of a submitted review

Released under the MIT License.