List Customer Reviews (GraphQL)

Returns the paginated review-moderation list. The reviewed product is a nested product object (id / name / sku) and the author is a nested customer object (id / name / email). Attached images resolve only on the detail query, not on the listing.

Arguments

All arguments are optional and combine in a single query — filter, sort and paginate together.

Pagination

Argument	Description
first	Number of records to return.
after	Cursor to fetch the page after (from pageInfo.endCursor).

Filters

Each filter narrows the result; supplying more than one combines with logical AND. They mirror the admin Reviews datagrid filters.

Argument	Type	Match
status	String	pending, approved or disapproved.
rating	Int	Exact rating value (1–5).
product_id	Int	Exact reviewed-product id.
customer_id	Int	Exact review-author id.
created_at_from	String	Reviewed on ≥ (date bound, e.g. "2026-06-01").
created_at_to	String	Reviewed on ≤ (date bound).

Sorting

Argument	Type	Values
sort	String	id (default), rating, created_at
order	String	asc, desc (default desc)

TIP

See the Reviews overview for how moderation works.

All admin operations require an admin Bearer token — see Authentication.