Get Client Review Values Reports

get https://a.klaviyo.com/client/review-values-reports

Get all reviews values reports in an account.

Rate limits:
Burst: 10/s
Steady: 150/m

Query Params

company_id

string

required

Your Public API Key / Site ID. See this article for more details.

fields[review-values-report]

array of strings

For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#sparse-fieldsets

fields[review-values-report]

filter

string

For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
product_external_ids: any, equals

group_by

string

required

group by value for this report

page[cursor]

string

For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#pagination

page[size]

integer

1 to 100

Defaults to 20

Default: 20. Min: 1. Max: 100.

statistics

string

required

list of statistics to calculate for this report

timeframe

string

required

timeframe window for value report

Headers

revision

string

required

Defaults to 2025-04-15

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

Language


xxxxxxxxxx
1
curl --request GET \
2
     --url 'https://a.klaviyo.com/client/review-values-reports?group_by=company_id&page[size]=20&timeframe=all_time' \
3
     --header 'accept: application/vnd.api+json' \
4
     --header 'revision: 2025-04-15'


xxxxxxxxxx
40
}
1
{
2
  "data": [
3
    {
4
      "type": "review-values-report",
5
      "id": "925e385b52fb405715f3616c337cc65c",
6
      "attributes": {
7
        "results": [
8
          {
9
            "groupings": {
10
              "product_id": "id1"
11
            },
12
            "statistics": {
13
              "total_ratings": 459,
14
              "average_rating": 4.5
15
            }
16
          },
17
          {
18
            "groupings": {
19
              "product_id": "id2"
20
            },
21
            "statistics": {
22
              "total_ratings": 459,
23
              "average_rating": 2.5
24
            }
25
          }

200Success

4XXClient Error

5XXServer Error