---
title: "Review by Review ID"
method: GET
path: "/v2/{account_id}/reviews/{review_id}"
---

# Review by Review ID

`GET /v2/{account_id}/reviews/{review_id}`

## Request

- Base URL: `https://developers.yotpo.com`
- URL: `https://developers.yotpo.com/v2/{account_id}/reviews/{review_id}`
- Auth: API key in header `X-Yotpo-Token`

Retrieve a specific review by `review_id`.

## Path parameters

- `account_id` string, required
- `review_id` string, required

## Query parameters

- `include_nested` boolean
- `include_site_reviews` boolean
- `include_unpublished_reviews` boolean

## Response `200`

200

- union
  - object
    - `status` object
      - `code` integer
      - `message` string
    - `pagination` unknown
    - `review` object
      - `review` object
        - `id` string
        - `score` integer
        - `votes_up` integer
        - `votes_down` integer
        - `content` string
        - `title` string
        - `created_at` string
        - `verified_buyer` boolean
        - `source_review_id` integer
        - `custom_fields` object
        - `images_data` unknown[]
          - unknown
        - `user` unknown
        - `product` unknown
        - `user_id` integer
        - `product_id` integer
        - `comment` unknown
        - `published` boolean
        - `order_id` integer
        - `external_order_id` string
        - `is_incentivized` boolean: `true` when the reviewer received an incentive for the review, such as a free product or a coupon.
        - `incentive_type` 'free_product' | 'coupon' | 'loyalty_points' | 'paid_promotion' | 'employee_review' | 'other' | '': The type of incentive: `free_product`, `coupon`, `loyalty_points`, `paid_promotion`, `employee_review` or `other`. An empty string when the review isn't incentivized.
        - `user_type` string: The kind of account that wrote the review, for example `AnonymousUser` for a shopper who reviewed without a Yotpo account.
  - object
    - `status` object
      - `code` integer
      - `message` string
    - `pagination` unknown
    - `review` object
      - `review` object
        - `id` string
        - `score` integer
        - `votes_up` integer
        - `votes_down` integer
        - `content` string
        - `title` string
        - `created_at` string
        - `verified_buyer` boolean
        - `source_review_id` integer
        - `custom_fields` object
        - `images_data` unknown[]
          - unknown
        - `user` object
          - `id` integer
          - `display_name` string
          - `social_image` string
          - `email` string
        - `product` unknown
        - `user_id` integer
        - `product_id` integer
        - `comment` unknown
        - `external_product_id` string
        - `published` boolean
        - `is_incentivized` boolean: `true` when the reviewer received an incentive for the review, such as a free product or a coupon.
        - `incentive_type` 'free_product' | 'coupon' | 'loyalty_points' | 'paid_promotion' | 'employee_review' | 'other' | '': The type of incentive: `free_product`, `coupon`, `loyalty_points`, `paid_promotion`, `employee_review` or `other`. An empty string when the review isn't incentivized.
        - `user_type` string: The kind of account that wrote the review, for example `AnonymousUser` for a shopper who reviewed without a Yotpo account.

## Other responses

- `400`: 400
- `401`: Missing or invalid access token. Send a valid token in the `X-Yotpo-Token` header.

## Changes

- **2026-11-03** `5bcae8239b6e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/yotpo/apis/app-developer-api/changes/v2/:account_id/reviews/:review_id/get.md)

---

[API](https://skmtc.dev/yotpo/apis/app-developer-api.md) - [All operations](https://skmtc.dev/yotpo/apis/app-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yotpo/apis/app-developer-api/revisions/5bcae8239b6e?raw)