---
title: "All Reviews"
method: GET
path: "/v2/{account_id}/reviews?access_token={access_token}"
---

# All Reviews

`GET /v2/{account_id}/reviews?access_token={access_token}`

Retrieve reviews data per account as a paginated response. This call will return reviews metrics such as review `id`, star-ratings `score`, `votes_up` or `votes_down`, review `content`, product identifiers, and more.

## Path parameters

- `account_id` string, required

## Query parameters

- `access_token` string, required
- `customer_email` string
- `include_nested` boolean
- `include_site_reviews` boolean
- `count` integer
- `page` integer
- `sort` string
- `direction` string
- `star` integer
- `include_unpublished_reviews` boolean
- `created_at_min` string, date
- `updated_at_min` string, date
- `is_incentivized` boolean
- `incentive_type` 'free_product' | 'coupon' | 'loyalty_points' | 'paid_ promotion' | 'employee_review' | 'other'

## Response `200`

200

- object
  - `status` object
    - `code` integer
    - `message` string
  - `pagination` object
    - `page` integer
    - `count` integer
    - `total` integer
  - `reviews` object
    - `reviews` 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
        - `--9728` object
          - `title` string
          - `form_id` integer
          - `value` string
          - `field_type` string
        - `--9729` object
          - `title` string
          - `form_id` integer
          - `value` string
          - `field_type` string
        - `--9730` object
          - `title` string
          - `form_id` integer
          - `value` string
          - `field_type` string
      - `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
      - `order_id` integer
      - `external_order_id` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/yotpo/apis/app-developer-api.md) · [All operations](https://skmtc.net/yotpo/apis/app-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yotpo/app-developer-api/revisions/4effe7674a3b/schema)