---
title: "List Reviews"
method: GET
path: "/reviews"
tags: ["reviews"]
---

# List Reviews

`GET /reviews`

Returns a list of Reviews for the requested store

## Query parameters

- `limit` integer
- `lastEvaluated` string
- `orderBy` string
- `status` 'approved' | 'pending' | 'rejected' — The moderation status of the review.

## Response `200`

An object containing a list of Reviews and a relative link to the next page of results if available.

- object
  - `reviews` object[]
    - `subscriberId` string, uuid, required — Your user id within Okendo.
    - `reviewId` string, uuid, required
    - `productId` string, required — The product ID prefixed by a platform identifier.
    - `attributesWithRating` object[]
      - `minLabel` string — The label for the leading edge of an attribute bar.
      - `midLabel` string — The label for the midpoint of a centered-range attribute bar.
      - `maxLabel` string — The label for the trailing edge of an attribute bar.
      - `title` string, required — The title of the attribute.
      - `type` 'centered-range' | 'range', required
      - `value` number, required — The value selected on the attribute scale. For attribute of type 'range' this is between 1 and 5. For 'centered-range', between -1 and 1.
    - `body` string, required — The content of the review.
    - `containsProfanity` boolean — true if the title or body contain words on the profanity list, otherwise false.
    - `dateCreated` string, date-time, required
    - `helpfulCount` integer — The number of upvotes a review has received.
    - `isIncentivized` boolean
    - `isRecommended` boolean
    - `media` object[]
      - `streamId` string, uuid, required
      - `fullSizeUrl` string, uri, required
      - `largeUrl` string, uri
      - `thumbnailUrl` string, uri, required
      - `type` 'image' | 'video', required
      - `isHidden` boolean, required
    - `productAttributes` object[]
      - `title` string, required — The title of the attribute.
      - `type` 'drop-down' | 'multi-value' | 'single-value', required
      - `value` union, required — The selected value(s) for the attribute. For types 'drop-down' and 'single-select' this is a single value. For type 'multi-select' it is an array.
        - string
        - string[]
    - `productName` string
    - `order` object
      - `orderId` string
      - `orderNumber` string
    - `rating` integer, required — The number of stars a review has received.
    - `reply` object
      - `body` string, html, required — The html representation of the review reply.
      - `dateCreated` string, date-time
      - `rawBody` string — The reply entered by the user. (Note: can include markdown syntax).
      - `isPrivate` boolean — true if the reply is unpublished otherwise false.
    - `reviewer` object, required
      - `attributes` object[]
        - `title` string, required — The title of the attribute.
        - `type` 'drop-down' | 'multi-value' | 'single-value', required
        - `value` union, required — The selected value(s) for the attribute. For types 'drop-down' and 'single-select' this is a single value. For type 'multi-select' it is an array.
          - string
          - string[]
      - `avatarUrl` string, uri
      - `displayName` string, required — The full name entered by the reviewer with the last name truncated.
      - `email` string, email
      - `isVerified` boolean
      - `location` object
        - `country` object
          - `code` string
          - `name` string
        - `zoneCode` string
      - `name` string, required — The full name entered by the reviewer.
      - `socialConnection` 'facebook' | 'google'
      - `verifiedStatus` 'Verified Buyer' | 'Verified Reviewer' — 'Verified Buyer' if the reviewer could be connected to a valid order. 'Verified Reviewer' if the reviewer could not be connected to a valid order but verified their email address.
    - `reward` object
      - `description` string
      - `integration` string
      - `type` 'coupon' | 'points' | 'event', required
      - `value` string, required
      - `isCouponUpgrade` boolean
    - `sentiment` 'positive' | 'negative' | 'neutral' | 'mixed' — The natural language sentiment of the review title and body.
    - `status` 'approved' | 'pending' | 'rejected', required — The moderation status of the review.
    - `tags` string[] — The names of any tags added to the review.
    - `title` string, required — The title of the review.
    - `unhelpfulCount` integer, required — The number of downvotes a review has received.
    - `variantId` string — The id of the reviewed Shopify product variant.
    - `variantName` string — The name of the reviewed Shopify product variant.
  - `nextUrl` string, uri

## Other responses

- `400` — Invalid request parameters.
- `401` — Authentication credentials are missing or incorrect.

---

[API](https://skmtc.dev/okendo/apis/okendo-enterprise-api.md) · [All operations](https://skmtc.dev/okendo/apis/okendo-enterprise-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/okendo/okendo-enterprise-api/revisions/dd4c80ed1613/schema)