---
title: "List reviews"
method: GET
path: "/v1/inbox/reviews"
tags: ["Reviews"]
---

# List reviews

`GET /v1/inbox/reviews`

Fetch reviews from all connected Facebook Pages and Google Business accounts. Aggregates data with filtering and sorting options.
Supported platforms: Facebook, Google Business.

## Query parameters

- `profileId` string
- `platform` 'facebook' | 'googlebusiness'
- `minRating` integer
- `maxRating` integer
- `hasReply` boolean
- `sortBy` 'date' | 'rating'
- `sortOrder` 'asc' | 'desc'
- `limit` integer
- `cursor` string
- `accountId` string

## Response `200`

Aggregated reviews

- object
  - `status` string
  - `data` object[]
    - `id` string — Review identifier. For Google Business this is the full review resource name (accounts/{accountId}/locations/{locationId}/reviews/{reviewId}), so it also encodes the location.
    - `platform` string
    - `accountId` string
    - `accountUsername` string
    - `locationId` string — Bare GBP location id the review belongs to. Google Business only; absent for other platforms.
    - `locationName` string, nullable — Human-readable GBP location display name. Google Business only; absent for other platforms.
    - `reviewer` object
      - `id` string, nullable
      - `name` string
      - `profileImage` string, nullable
    - `rating` integer
    - `text` string
    - `created` string, date-time
    - `hasReply` boolean
    - `hasPhotos` boolean — Whether the review has at least one photo. Google Business only; always false for other platforms.
    - `photoCount` integer — Number of photos attached to the review (photos only; videos are not counted). Google Business only; 0 for other platforms.
    - `photos` object[] — Photos attached to the review. Google Business only; always an empty array for other platforms.
      - `url` string, uri
    - `reply` object, nullable
      - `id` string
      - `text` string
      - `created` string, date-time
    - `reviewUrl` string, nullable
  - `pagination` object
    - `hasMore` boolean
    - `nextCursor` string, nullable
  - `meta` object
    - `accountsQueried` integer
    - `accountsFailed` integer
    - `failedAccounts` object[]
      - `accountId` string
      - `accountUsername` string, nullable
      - `platform` string
      - `error` string
      - `code` string, nullable — Error code if available
      - `retryAfter` integer, nullable — Seconds to wait before retry (rate limits)
    - `lastUpdated` string, date-time
  - `summary` object
    - `totalReviews` integer
    - `averageRating` number, nullable

## Other responses

- `401` — Unauthorized
- `403` — Inbox addon required

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/revisions/15e893e69e8c/schema)