---
title: "Retrieve a paginated list of a restaurant's reviews"
method: GET
path: "/api/v1/restaurants/{restaurant_id}/reviews"
tags: ["Review"]
---

# Retrieve a paginated list of a restaurant's reviews

`GET /api/v1/restaurants/{restaurant_id}/reviews`

## Request

- Base URL: `https://gotable.app`
- URL: `https://gotable.app/api/v1/restaurants/{restaurant_id}/reviews`
- Auth: HTTP bearer

## Path parameters

- `restaurant_id` integer, required

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

With a valid API token

- object
  - `reviews` Review[]
    - `id` integer: The unique ID of the review
    - `restaurant_id` integer: The unique ID of the restaurant the review was left for
    - `reservation_id` integer: The unique ID of the reservation the review followed
    - `guest_id` integer, nullable: The unique ID of the guest who left the review, when it could be linked to one
    - `author_name` string: The name the review was signed with
    - `author_email` string: The email address the review was left with
    - `rating` integer, nullable: The rating the guest gave, from 1 to 10. Reviews without a rating are text only.
    - `description` string: What the guest wrote
    - `state` 'unchecked' | 'approved': Whether the restaurant has accepted the review yet. Rejected reviews are not returned.
    - `created_at` string, date-time: When the review was left
    - `updated_at` string, date-time: When the review was last changed
    - `links` Link[]: An array of links useful for this review
      - `href` string: The URL to the related resource.
      - `method` 'GET' | 'POST' | 'PUT' | 'DELETE': The HTTP method that should be used to follow the link.
      - `rel` string: The relationship of this link to the current resource.
  - `meta` Pagination
    - `current_page` integer
    - `per_page` integer
    - `total_pages` integer
    - `total_count` integer
    - `links` Link[]: An array of pagination links
      - `href` string: The URL to the related resource.
      - `method` 'GET' | 'POST' | 'PUT' | 'DELETE': The HTTP method that should be used to follow the link.
      - `rel` string: The relationship of this link to the current resource.

## Other responses

- `401`: With an invalid API token
- `403`: With an unauthorized API token
- `404`: With a non-existant Restaurant ID

---

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