Get Customer Review

About

The customerReview query retrieves a single product review by its ID for the authenticated customer. Customers can only access their own reviews. Use this query to:

• Display detailed review information
• Show the full review text and rating
• Check the approval status of a specific review
• Load a review for detailed viewing in the customer dashboard

Authentication

This query requires customer authentication:

• Authenticated customers: Provide a valid customer authentication token in the Authorization header. Obtain this token via the Customer Login API.

Authorization: Bearer <accessToken>
X-STOREFRONT-KEY: <storefrontKey>

Arguments

Argument	Type	Required	Description
id	ID!	✅ Yes	The IRI identifier of the customer review (e.g. /api/shop/customer-reviews/1).

Possible Returns

Field	Type	Description
id	ID!	IRI identifier (e.g. /api/shop/customer-reviews/1).
_id	Int!	Numeric database ID.
title	String!	Review title.
comment	String!	Review body text.
rating	Int!	Star rating (1–5).
status	String!	Review status: pending, approved, or rejected.
name	String!	Reviewer display name.
product	Product!	Associated product with id, _id, sku.
customer	Customer!	Customer who wrote the review with id, _id.
createdAt	DateTime!	ISO 8601 creation timestamp.
updatedAt	DateTime!	ISO 8601 last update timestamp.

Error Responses

Error	Cause
Unauthenticated	Missing or invalid Bearer token
Customer review ID is required	ID not provided for single-item query
Customer review with ID ":id" not found	Review doesn't exist or doesn't belong to the customer

Use Cases

• Display individual review details in customer account
• Show review with full context and approval status
• Load specific review for viewing or tracking
• Check if a submitted review has been approved

Related Resources

• Get All Customer Reviews — Query all customer reviews
• Get Product Reviews — Query all product reviews
• Create Product Review — Submit a new product review