> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://api-docs.papertracc.com/storefront/reviews/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://api-docs.papertracc.com/_mcp/server.

# Overview

Product reviews come only from signed-in shoppers who have ordered the product, and every review waits for the merchant's approval before it is listed.

## Who can review

A shopper can review a product when one of their orders contains it and that order was not cancelled. Others get `422` with `only shoppers who have ordered this product can review it`. Each shopper has one review per product; submitting again replaces it and sends it back for approval.

## Showing reviews

* Get Product returns `rating` with the average and the number of approved reviews.
* List Reviews returns the approved reviews, newest first, with the same rating summary.
* `author_name` is the shopper's first name and last initial, such as `Ada O.`.
* If the merchant has replied, the reply is in `reply` and the time it was saved in `replied_at`; both are `null` otherwise. Show the reply under the review. The merchant replies, edits and removes replies in the Papertracc app.
* When a shopper resubmits a review, the merchant's earlier reply stays until the merchant changes or removes it.

Review text is plain; markup is removed. A shopper can submit 10 reviews in 15 minutes.


## API Docs

- Reviews [List Reviews](https://api-docs.papertracc.com/storefront/reviews/list-reviews.md)
- Reviews [Create Review](https://api-docs.papertracc.com/storefront/reviews/create-review.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://api-docs.papertracc.com/openapi.json)
- [OpenAPI YAML](https://api-docs.papertracc.com/openapi.yaml)