---
title: "Get reviews"
method: GET
path: "/v1/accounts/{accountId}/gmb-reviews"
tags: ["GMB Reviews"]
---

# Get reviews

`GET /v1/accounts/{accountId}/gmb-reviews`

Returns reviews for a Google Business Profile account including ratings, comments, and owner replies. Use nextPageToken for pagination.

## Path parameters

- `accountId` string, required

## Query parameters

- `locationId` string
- `pageSize` integer
- `pageToken` string

## Response `200`

Reviews fetched successfully

- object
  - `success` boolean
  - `accountId` string
  - `locationId` string
  - `reviews` GoogleBusinessReview[]
    - `id` string — Review ID
    - `name` string — Full resource name
    - `reviewer` object
      - `displayName` string
      - `profilePhotoUrl` string, nullable
      - `isAnonymous` boolean
    - `rating` integer — Numeric star rating (0 when Google sends no rating)
    - `starRating` 'ONE' | 'TWO' | 'THREE' | 'FOUR' | 'FIVE' — Google's string rating
    - `comment` string — Review text
    - `createTime` string, date-time
    - `updateTime` string, date-time
    - `reviewReply` object, nullable
      - `comment` string — Business owner reply
      - `updateTime` string, date-time
    - `photoCount` integer — Number of photos attached to the review (photos only, videos are not counted)
    - `photos` object[] — Photos attached to the review by the reviewer
      - `url` string, uri
  - `averageRating` number — Overall average rating
  - `totalReviewCount` integer — Total number of reviews
  - `nextPageToken` string, nullable — Token for next page

## Other responses

- `400` — Invalid request - not a Google Business Profile account or missing location
- `401` — Unauthorized or token invalid
- `403` — Permission denied for this location
- `404` — Resource not found
- `500` — Failed to fetch reviews
- `502` — The platform returned a server error.
- `503` — An upstream service or database is temporarily unavailable. Retry after the indicated delay. A timed-out write may have completed upstream; check its outcome before resubmitting.

## Changes

- **2026-09-16** `3e6ddf2a99ea` — 6 info
  - added the optional property `details/budgetScope` to the response with the `400` status
  - added the optional property `details/budgetScope` to the response with the `401` status
  - added the optional property `details/budgetScope` to the response with the `403` status
  - added the optional property `details/budgetScope` to the response with the `500` status
  - …2 more
- **2026-09-15** `0dba7d004d75` — 12 info
  - added the optional property `details/quotaExhausted` to the response with the `400` status
  - added the optional property `details/quotaExhausted` to the response with the `401` status
  - added the optional property `details/quotaExhausted` to the response with the `403` status
  - added the optional property `details/quotaExhausted` to the response with the `500` status
  - …8 more
- **2026-09-10** `e70ed06e7150` — 2 info
  - added the non-success response with the status `502`
  - added the non-success response with the status `503`
- **2026-08-26** `b5344d376e5e` — 1 breaking
  - the `reviews/items/rating` response property's min was decreased from `1.00` to `0.00` for the response status `200`

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/accounts/:accountId/gmb-reviews/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) · [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/a0d8f21b5abe?raw)