---
title: "Retrieve bottomline scores"
method: GET
path: "/v3/storefront/stores/{storeId}/ratings"
---

# Retrieve bottomline scores

`GET /v3/storefront/stores/{storeId}/ratings`

## Request

- Base URL: `https://api-cdn.yotpo.com`
- URL: `https://api-cdn.yotpo.com/v3/storefront/stores/{storeId}/ratings`
- Auth: none required

Retrieve bottomline scores for each product in a store.

## Path parameters

- `storeId` string, required

## Query parameters

- `perPage` integer, required
- `page` integer, required

## Response `200`

OK

- object
  - `status` object: Response status.
    - `code` integer: HTTP status code.
    - `message` string: Status message.
  - `response` object: Response payload.
    - `pagination` object: Pagination details.
      - `page` integer: Current page number.
      - `perPage` integer: Results per page.
      - `total` integer: Total number of products across all pages.
    - `bottomlines` object[]: Review summary per product.
      - `productId` string: Product ID (domain key) in your store.
      - `totalReviews` integer: Number of published reviews.
      - `averageScore` number: Average star rating (0 to 5).
      - `totalOrganicReviews` integer: Number of organic (non-incentivized, non-imported) reviews.
      - `organicAverageScore` number: Average star rating of organic reviews.

## Other responses

- `400`: A required query parameter is missing.
- `404`: Unknown store ID. The body is the plain string `Account not found`. An unknown product ID returns `200` with no data instead.

---

[API](https://skmtc.dev/yotpo/apis/ugc-storefront-api.md) - [All operations](https://skmtc.dev/yotpo/apis/ugc-storefront-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yotpo/apis/ugc-storefront-api/revisions/09189726cf4b?raw)