---
updatedAt: 2026-10-29T10:55:14.000Z
agentTools:
  projectIndex: https://docs.yotpo.com/llms.txt
---

# Retrieve a review by review ID

Retrieves a single review by its `review_id`.

> 📘 Public endpoint
>
> No access token is needed. Deleted reviews return `401`.

> 👍 How to use this API
>
> * Requests for this endpoint are limited to 5,000 requests/minute, per app key.
> * Data is retrieved with a delay of 1 hour.
> * For example responses, click the relevant status code on the right.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Reviews API (V1)",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.yotpo.com",
      "description": "Main API server for authenticated and write operations"
    }
  ],
  "components": {
    "securitySchemes": {
      "X-Yotpo-Token": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Yotpo-Token",
        "description": "Your Yotpo account access token. See [Yotpo Authentication](ref:yotpo-authentication) to learn how to generate your token."
      }
    }
  },
  "security": [
    {
      "X-Yotpo-Token": []
    }
  ],
  "paths": {
    "/reviews/{review_id}": {
      "get": {
        "summary": "Retrieve a review by review ID",
        "description": "Retrieves a single review by its ID. Public: no access token needed. Deleted reviews return `401`.",
        "operationId": "retrieve-a-review-by-review-id",
        "parameters": [
          {
            "name": "review_id",
            "in": "path",
            "description": "The review id",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"status\": {\n    \"code\": 200,\n    \"message\": \"OK\"\n  },\n  \"response\": {\n    \"review\": {\n      \"id\": 1010591,\n      \"content\": \"Tolles Produkt zu fairen Preisen\",\n      \"title\": \"Tolles Produkt\",\n      \"score\": 5,\n      \"user\": {\n        \"id\": 650200,\n        \"display_name\": \"Wolfgang Mau\",\n        \"slug\": \"wolfgang-mau\",\n        \"social_image\": \"https://lh3.googleusercontent.com/-XdUIqdMkCWA/AAAAAAAAAAI/AAAAAAAAAAA/4252rscbv5M/photo.jpg\",\n        \"is_social_connected\": true,\n        \"bio\": null,\n        \"score\": 0,\n        \"badges\": [\n          {\n            \"id\": 1,\n            \"name\": \"Newbie\",\n            \"description\": \"Hooray, you wrote your first review with Yotpo! Now you have this cool profile page, and you can earn Yotpo score and have even more badges.\",\n            \"image_100\": \"http://s3.amazonaws.com/yotpo-static-images/badges/100/1.png\",\n            \"image_300\": \"http://s3.amazonaws.com/yotpo-static-images/badges/300/1.png\"\n          }\n        ]\n      },\n      \"user_type\": \"User\",\n      \"users\": [],\n      \"products\": [\n        {\n          \"Location_idx\": [\n            0,\n            0\n          ],\n          \"Product\": {\n            \"product_url\": \"http://my.yotpo.com\",\n            \"id\": 1739260,\n            \"name\": \"Canon EOS 5D Mark II\",\n            \"slug\": \"canon-eos-5d-mark-ii--2\",\n            \"shorten_url\": \"https://yotpo.com/go/8sPQAjFl\",\n            \"images\": [\n              {\n                \"id\": 1705775,\n                \"image_url\": \"http://ddcfq0gxiontw.cloudfront.net/Product/1739260/1705775/square.jpg?1455184269\",\n                \"big_image_url\": \"http://ddcfq0gxiontw.cloudfront.net/Product/1739260/1705775/big.jpg?1455184269\"\n              }\n            ],\n            \"social_network_links\": {\n              \"facebook\": \"https://yotpo.com/go/3gfFbHuY\",\n              \"twitter\": \"https://yotpo.com/go/8RneA6fJ\",\n              \"linkedin\": \"https://yotpo.com/go/1dxwNwR1\",\n              \"google_oauth2\": \"https://yotpo.com/go/iiJdm1XC\"\n            },\n            \"facebook_testemonials_page_product_url\": \"https://yotpo.com/go/hLGFhtvz\"\n          }\n        }\n      ],\n      \"votes_up\": 1,\n      \"votes_down\": 0,\n      \"user_vote\": 0,\n      \"sentiment\": 0.732,\n      \"created_at\": \"2014-03-18T09:27:45.792Z\",\n      \"deleted\": false,\n      \"new\": false,\n      \"verified_buyer\": false,\n      \"archived\": false,\n      \"social_pushed\": false,\n      \"facebook_pushed\": 0,\n      \"twitter_pushed\": 0,\n      \"account\": {\n        \"id\": 4,\n        \"domain\": \"widget.yotpo.com\"\n      },\n      \"products_apps\": [\n        {\n          \"id\": 1696312,\n          \"product_url\": \"http://my.yotpo.com\",\n          \"domain_key\": \"B000HT3P7E\",\n          \"product\": {\n            \"id\": 1739260,\n            \"name\": \"Canon EOS 5D Mark II\"\n          }\n        }\n      ]\n    }\n  }\n}"
                  }
                }
              }
            },
            "headers": {
              "ratelimit-limit": {
                "description": "The maximum number of requests allowed in the current time window",
                "schema": {
                  "type": "integer"
                }
              },
              "ratelimit-remaining": {
                "description": "The number of requests remaining in the current time window",
                "schema": {
                  "type": "integer"
                }
              },
              "ratelimit-reset": {
                "description": "The time (in seconds) until the rate limit resets",
                "schema": {
                  "type": "integer"
                }
              },
              "x-ratelimit-limit-minute": {
                "description": "The maximum number of requests allowed per minute",
                "schema": {
                  "type": "integer"
                }
              },
              "x-ratelimit-remaining-minute": {
                "description": "The number of requests remaining in the current minute",
                "schema": {
                  "type": "integer"
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            },
            "headers": {
              "ratelimit-limit": {
                "description": "The maximum number of requests allowed in the current time window",
                "schema": {
                  "type": "integer"
                }
              },
              "ratelimit-remaining": {
                "description": "The number of requests remaining in the current time window",
                "schema": {
                  "type": "integer"
                }
              },
              "ratelimit-reset": {
                "description": "The time (in seconds) until the rate limit resets",
                "schema": {
                  "type": "integer"
                }
              },
              "x-ratelimit-limit-minute": {
                "description": "The maximum number of requests allowed per minute",
                "schema": {
                  "type": "integer"
                }
              },
              "x-ratelimit-remaining-minute": {
                "description": "The number of requests remaining in the current minute",
                "schema": {
                  "type": "integer"
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": []
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "value": "application/json",
        "key": "Content-Type"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```

# Sibling pages

* [About reviews (merchant)](https://docs.yotpo.com/reference/about-merchant-reviews.md)
* [Create review](https://docs.yotpo.com/reference/create-review.md)
* [Create review (synchronous)](https://docs.yotpo.com/reference/create-review-synchronous.md)
* [Upload Images With Reviews Via API](https://docs.yotpo.com/reference/upload-images-with-reviews.md)
* [Retrieve reviews for a user using external user reference ID](https://docs.yotpo.com/reference/retrieve-reviews-for-a-specific-user.md)
* [About SEO](https://docs.yotpo.com/reference/about-seo.md)