Ratings API Documentation

Overview

Fetch ratings for a location for a given time period (maximum time period is one week)

API

Get ratings

Required Scope: prod/transaction

URL (single location):

Method: GET
Path: /api/ratings/v1/:locationId

Query parameters: 

from-date Time period start (UTC)
to-date Time period end (UTC)


Example request:

https://favrit.com/ws/accounting-api-service/api/ratings/v1/1234?from-date=2025-03-01T00%3A00%3A00&to-date=2025-03-07T00%3A00%3A00

Response

data: array[Rating]

Rating:

Keep in mind that many of these fields are optional and may not contain any data. We may also add new fields in the future, so your implementation should be prepared to receive unknown fields and values.

Field Type Description
id uuid Unique id
locationId numeric Location id
comment text Comment left by guest
rating numeric Star rating 1 - 5
orderReference text Order reference
category text  Category selected by guest
tableOrDeliveryPoint text  Point of delivery (table, takeaway etc.)
orderCreatedUtc datetime When the order was created (not necessarily the same as time of payment)
registeredUtc datetime When the rating was registered
choices array[text] Guest may specify which areas the rating applies to

 

Model:

Rating (
String id,
Long locationId,
String comment,
Integer rating,
String orderReference,
String category,
String tableOrDeliveryPoint,
LocalDateTime orderCreatedUtc,
LocalDateTime registeredUtc,
List<String> choices
)