Get Customer Reviews
Retrieve a paginated list of product reviews submitted by the authenticated customer. This is a read-only, customer-scoped resource — customers can only see their own reviews.
Endpoint
GET /api/shop/customer-reviewsRequest Headers
| Header | Required | Description |
|---|---|---|
Content-Type | Yes | application/json |
X-STOREFRONT-KEY | Yes | Your storefront API key |
Authorization | Yes | Bearer token (customer login required) |
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
status | string | - | Filter by review status (pending, approved, rejected) |
rating | integer | - | Filter by star rating (1–5) |
Response Fields (200 OK)
| Field | Type | Description |
|---|---|---|
id | integer | Review ID |
title | string | Review title |
comment | string | Review body text |
rating | integer | Star rating (1–5) |
status | string | Review status: pending, approved, or rejected |
name | string | Reviewer display name |
product | object | Associated product (nested resource) |
customer | object | Customer who wrote the review (nested resource) |
createdAt | string | ISO 8601 creation timestamp |
updatedAt | string | ISO 8601 last update timestamp |
Status Values
| Status | Description |
|---|---|
pending | Awaiting approval |
approved | Published on storefront |
rejected | Not published |
Filters
bash
# Get approved reviews only
GET /api/shop/customer-reviews?status=approved
# Get 5-star reviews only
GET /api/shop/customer-reviews?rating=5
# Get approved 5-star reviews
GET /api/shop/customer-reviews?status=approved&rating=5
# Get pending reviews
GET /api/shop/customer-reviews?status=pending
# Get rejected reviews
GET /api/shop/customer-reviews?status=rejectedUse Cases
- Display customer's review history in account dashboard
- Show pending reviews awaiting approval
- Filter reviews by rating or status
- Build review management UI for customers