List Reviews

Retrieves a list of reviews based on the provided filters.

GET /reviews

List Reviews

cURL

curl --request GET \
  --url https://api-dev.myrestoo.net/v3/reviews \
  --header 'Authorization: Bearer <token>' \
  --header 'Restoo-Account-Id: <restoo-account-id>' \
  --header 'Restoo-Partner-Id: <restoo-partner-id>'

200

{
  "data": [
    {
      "booking": {
        "uuid": "50b5571be67b477baa9dead4b290c555",
        "bookingAt": "2025-03-20T23:00:00+02:00",
        "status": "CONFIRMED",
        "isTimeLimited": true,
        "isReconfirmed": true,
        "isReconfirmedByCustomer": false,
        "cancelReason": "CHANGED_PLANS",
        "bookingPartner": "GOOGLE",
        "bookingExternalId": "book_123456",
        "shiftType": {
          "id": "LUNCH",
          "name": "Lunch"
        },
        "floorPlanArea": {
          "name": "Terrace",
          "id": 101
        },
        "promo": {
          "name": "Summer Discount 2025",
          "id": 101
        },
        "product": {
          "orderItemId": 101,
          "orderUuid": "50b5571be67b477baa9dead4b290c555",
          "currency": "EUR",
          "experienceTickets": 1,
          "id": 101,
          "isGift": true,
          "name": "Gift Card",
          "quantity": 1,
          "taxRate": 1050,
          "type": "ITEM",
          "unitPrice": 7500
        },
        "experience": {
          "tickets": 1,
          "discount": 10.5,
          "experienceId": 123,
          "name": "Premium Menu",
          "pricePerTicket": 7500,
          "currency": "EUR",
          "id": 101
        },
        "addOns": [
          {
            "addOnId": 123,
            "name": "Premium wine tasting",
            "unitPrice": 1000,
            "currency": "EUR",
            "id": 101,
            "quantity": 1
          }
        ],
        "customer": {
          "uuid": "50b5571be67b477baa9dead4b290c555",
          "language": "en",
          "contactMethods": [
            "EMAIL"
          ]
        },
        "accountId": "best-burger",
        "highChairs": 1,
        "paxChildren": 0,
        "pax": 2,
        "strollers": 1,
        "turnMinutes": 90
      },
      "id": 42,
      "createdAt": "2026-07-20T12:00:00+02:00",
      "updatedAt": "2026-07-21T14:30:00+02:00",
      "isReplied": false,
      "questions": [
        {
          "id": "OVERALL_EXPERIENCE",
          "type": "MOOD",
          "label": "Overall experience",
          "answer": "EXCELLENT"
        }
      ]
    }
  ],
  "meta": {}
}

Authorizations

Authorization · string · header · required

All requests must include the static API Key in the Authorization header using the Bearer scheme.

Headers

Restoo-Partner-Id · string · required

Unique identifier of your Partner account (defined by Restoo).

Restoo-Account-Id · string · required

Unique identifier of the Tenant.

Query Parameters

per_page · integer · default: 100

The number of results that will be returned per page

Required range: 1 <= x <= 500

Example:

100

page · integer · default: 1

The page number to start the pagination from

Required range: x >= 1

Example:

1

date_end · string<date>

Return only records created at or before this date, in ISO 8601 format (YYYY-MM-DD). Must be equal to or later than date_start

Example:

"2026-12-31"

date_start · string<date>

Return only records created at or after this date, in ISO 8601 format (YYYY-MM-DD)

Example:

"2026-01-01"

updated_since · string<date-time>

Return only records updated at/on or after this timestamp, in ISO 8601 format (YYYY-MM-DDTHH:mm:ss). Useful for incremental synchronization

Example:

"2026-07-20T12:00:00"

Response

200

application/json

data · (AnonymizedReviewResponse · object | PrivateReviewResponse · object | PublicReviewResponse · object)[] · required

AnonymizedReviewResponse

PrivateReviewResponse

PublicReviewResponse

Show child attributes

meta · object · required