> ## Documentation Index > Fetch the complete documentation index at: https://docs.nautilus.co/llms.txt > Use this file to discover all available pages before exploring further. # List Google reviews > Returns Google reviews for sites owned by the organization encoded in the tenant API key, and for sites of organizations whose super organization is that tenant. Deleted reviews and thin Places-API preview placeholders are excluded; only synced Business Profile reviews are returned. Sorted newest first. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/reviews openapi: 3.1.0 info: title: Nautilus Public API version: 1.0.0 description: >- The canonical /api/v1 data endpoints are tenant-scoped and use a Clerk tenant API key as a Bearer token. The key's organizationId is the sole tenant scope; caller-supplied organization IDs are not accepted. Detail reads return 404 for both missing and cross-tenant records. Canonical collections use the standard envelope and endpoint-bound cursor pagination. Timestamps are UTC ISO 8601 values and monetary amounts ending in Cents are integer cents. Responses use narrow serializers that exclude credentials and internal provider or workflow data. GET /api/v1/openapi.json and the headless form submission endpoint do not require an API key. Headless submissions use a published form ID and its configured form password, grant submission access only, and return the separate receipt/error shapes documented on that operation. Use headless submissions for published forms supported by headless intake. Copy the endpoint and saved field IDs from Share > Use your own form; hosted-only form requirements remain unchanged. servers: - url: https://app.nautilus.co security: - tenantApiKey: [] tags: - name: Contract - name: Cancellations - name: Sites - name: Products - name: Checkout links - name: Purchases - name: Contact lists - name: Contacts - name: Marketing - name: Forms - name: Vouchers - name: Links - name: Automations - name: Surveys - name: Cases - name: Reviews - name: POS description: >- Point-of-sale data for the organization that owns the API key. The POS is resolved server-side from that organization; requests never name or select a provider. - name: Analytics - name: Messaging - name: Legacy description: Deprecated noncanonical endpoints retained for compatibility. paths: /api/v1/reviews: get: tags: - Reviews summary: List Google reviews description: >- Returns Google reviews for sites owned by the organization encoded in the tenant API key, and for sites of organizations whose super organization is that tenant. Deleted reviews and thin Places-API preview placeholders are excluded; only synced Business Profile reviews are returned. Sorted newest first. operationId: listReviews parameters: - name: siteId in: query required: false schema: type: string description: Nautilus site identifier. - name: rating in: query required: false schema: type: integer minimum: 1 maximum: 5 description: Exact star rating. - name: replied in: query required: false schema: type: boolean description: >- true returns only reviews with an owner reply; false returns only reviews without one. - name: createdAfter in: query required: false schema: type: string format: date-time description: UTC ISO 8601 timestamp. description: >- Inclusive review creation lower bound. Must include an explicit UTC offset. - name: createdBefore in: query required: false schema: type: string format: date-time description: UTC ISO 8601 timestamp. description: >- Inclusive review creation upper bound. Must include an explicit UTC offset. - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 500 default: 100 description: >- Page size. Invalid values use 100; values above 500 are capped at 500. - name: cursor in: query required: false schema: type: string description: >- Opaque continuation token returned by this reviews collection. Cursors are bound to this endpoint (and, for nested or sorted collections, to that parent or sort) and cannot be reused elsewhere. responses: '200': description: Tenant-scoped collection. content: application/json: schema: allOf: - $ref: '#/components/schemas/CollectionEnvelope' - type: object properties: data: type: array items: $ref: '#/components/schemas/GoogleReview' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '500': $ref: '#/components/responses/InternalServerError' components: schemas: CollectionEnvelope: type: object additionalProperties: false properties: organizationId: type: string filters: type: object additionalProperties: true description: Normalized filters actually applied to the request. data: type: array items: {} pagination: $ref: '#/components/schemas/Pagination' required: - organizationId - filters - data - pagination description: Standard envelope for canonical collection endpoints. GoogleReview: type: object additionalProperties: false properties: reviewId: type: string format: uuid googleReviewId: type: string googleLocationId: type: string organizationId: type: string site: type: object additionalProperties: false properties: siteId: type: string name: type: string required: - siteId - name rating: type: integer minimum: 1 maximum: 5 comment: anyOf: - type: string - type: 'null' reviewer: type: object additionalProperties: false properties: name: anyOf: - type: string - type: 'null' anonymous: type: boolean photoUrl: anyOf: - type: string - type: 'null' required: - name - anonymous - photoUrl createdAt: type: string format: date-time description: UTC ISO 8601 timestamp. updatedAt: type: string format: date-time description: UTC ISO 8601 timestamp. reply: anyOf: - type: object additionalProperties: false properties: comment: type: string updatedAt: anyOf: - type: string format: date-time description: UTC ISO 8601 timestamp. - type: 'null' required: - comment - updatedAt - type: 'null' required: - reviewId - googleReviewId - googleLocationId - organizationId - site - rating - comment - reviewer - createdAt - updatedAt - reply description: >- Google Business Profile review mapped to a Nautilus site. reviewId is the stable Nautilus identifier; googleReviewId is Google's. organizationId is the organization that owns the mapped site. Raw provider payloads, AI reply drafts, and dispute analyses are never exposed. Pagination: type: object additionalProperties: false properties: limit: type: integer hasMore: type: boolean nextCursor: anyOf: - type: string - type: 'null' required: - limit - hasMore - nextCursor Error: type: object additionalProperties: false properties: error: type: string required: - error responses: BadRequest: description: >- Malformed parameters, unsupported provider, or unavailable resource for this organization. content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: Missing, invalid, legacy, or non-tenant Bearer credential. content: application/json: schema: $ref: '#/components/schemas/Error' InternalServerError: description: Internal server error. No internal exception data is exposed. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: tenantApiKey: type: http scheme: bearer bearerFormat: Clerk tenant API key description: >- Clerk tenant API key. The organizationId encoded by the key is the exact and only tenant scope. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.