--- title: "Get a list of reviews with fewer properties per each item." method: GET path: "/reviews-minimal" tags: ["Endpoints"] --- # Get a list of reviews with fewer properties per each item. `GET /reviews-minimal` This endpoint retrieves reviews for a specific channel, a set of channels or for your entire account. The response items have fewer properties compared to that of the [/reviews](/reference/getreviews) endpoint which returns review items containing all properties. The results can be filtered by appending any of the provided query parameters to the endpoint URL. Remember to use `&` as a separator for multiple parameters eg: `/reviews-minimal?channels=chl-xxx-yyyy&submittedAfter=2018-02-01T17:10:42.733Z` Also, for pagination, you have the following query parameters `count`, `after` and `before`. See our guide on [paginating response data](/reference/pagination) to learn how to use them. > **Custom Widget Implementation:** Please note the response may include rejected reviews when using a custom widget. To prevent these from appearing, filter out reviews with the `status` attribute set to `REJECTED`. ## Query parameters - `channels` string[] - `after` string - `before` string - `submittedAfter` string - `submittedBefore` string - `count` integer - `rating` integer[] - `status` string[] - `type` string[] - `hasReply` boolean - `ignoreStatements` boolean - `query` string - `sku` string[] - `orderBy` string ## Headers - `Authorization` string, required ## Response `200` The list of reviews for the given channels or all channels. - MinimalCustomerReviewListResponseDto — The list of retrieved reviews with mininal fields. - `paging` object, required — The paging object holds pagination information for the reviews retrieved via this API. - `cursor` object, required — The cursor object contains information to navigate to the previous and next pages in a subsequent request. - `before` string, required — This is a review ID to retrieve the previous page in the pagination. - `after` string — This is a review ID to retrieve the next page in the pagination. It is empty if it is the last page in the pagination. - `items` MinimalCustomerReviewResponseDto[], required — This is the list of review objects. Each `item` object represents a single retrieved review. - `id` string, required — The customer review UUID. - `channelRef` string, required — A UUID as channel reference. - `rating` number, required — The star rating. The value ranges from `1.0` to `5.0`. - `title` string, required — A title headline for this customer review. - `comment` string, required — The review text for this customer review. - `submittedAt` string, date-time, required — The date and time when the customer review was submitted by the reviewer, in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) and [RFC 3339](https://tools.ietf.org/html/rfc3339) compliant format `yyyy-MM-dd’T’HH:mm:ss.SSSZ`. Check the [glossary](/docs/glossory#iso-8601) for examples of valid datetime formats. - `state` 'SUBMITTED' | 'APPROVED' | 'REJECTED' | 'MODERATION' | 'DISCARDED', required — The state of the customer review when the API request was processed. See [our glossary entry](https://developers.etrusted.com/glossary.html#review) for more information on review states. - `reply` CustomerReviewReplyDto — The reply to the customer review, written by the channel owner. - `createdAt` string, date-time, required — The date and time when the reply was stored initially, in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) and [RFC 3339](https://tools.ietf.org/html/rfc3339) compliant format `yyyy-MM-dd’T’HH:mm:ss.SSSZ`. Check the [glossary](/docs/glossory#iso-8601) for examples of valid datetime formats. - `updatedAt` string, date-time, required — The date and time when the reply was last updated, in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) and [RFC 3339](https://tools.ietf.org/html/rfc3339) compliant format `yyyy-MM-dd’T’HH:mm:ss.SSSZ`. Check the [glossary](/docs/glossory#iso-8601) for examples of valid datetime formats. - `comment` string, required — The text message of the reply. - `sendNotification` boolean — Indicates whether the reviewer is notified about the reply by *eTrusted* or not. - `customer` object — This object holds information about the customer who wrote the review. - `firstName` string — The first name of the customer. - `lastName` string — The last name of the customer. - `fullName` string — The full name of the customer. - `email` string — An email address of the customer. - `mobile` string — A mobile phone number of the customer. - `hasAttachments` boolean — This indicates if the whether the customer review has attachments, such as images. - `product` CustomerReviewResponseProductDto — The product data retrieved with the customer review. - `id` string, required — The product UUID. - `sku` string, required — The Stock Keeping Unit is a specific article number of the product, most often assigned by a specific retail shop as a scannable bar code. It lets the shops track movement of inventory. The SKU must be unique and usually consists of about 8 characters. - `mpn` string — The Manufacturer Part Number is an identifier for a product by the manufacturer if applicable. In some cases it can serve as a substitute for the GTIN. - `gtin` string — The GTIN is a unique string that identifies the product globally. A GTIN can be an ISBN, an EAN, and much more. Refer to [gtin.info](https://www.gtin.info/). - `name` string, required — The product name contains information about a product that is associated with the customer review. E.g. `Specialbrand T-Shirt White M`. - `url` string, required — The link to the product detail page in your online shop or public catalog (e.g. http://www.specialbrandshop.com/article123-TS-WH-M/). - `imageUrl` string — The link to the product image of the product. eTrusted shows a picture of the product to the customer who wants to write a review. This makes it easier for customers to remember the purchase and recognize the product. - `brand` string — The brand of the product. A product can only have one brand. - `editedAt` string, date-time — The date and time when the customer review was last edited by the consumer via our B2C world, in the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) and [RFC 3339](https://tools.ietf.org/html/rfc3339) compliant format `yyyy-MM-dd’T’HH:mm:ss.SSSZ`. Check the [glossary](/docs/glossory#iso-8601) for examples of valid datetime formats. Will not be present in the response when the review was never edited by the consumer. ## Other responses - `401` — Unauthorized - `403` — Forbidden - `404` — Not found --- [API](https://skmtc.net/etrusted/apis/accounts-api.md) · [All operations](https://skmtc.net/etrusted/apis/accounts-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/etrusted/accounts-api/versions/649ef7dac98c/schema)