# Reviews

Some accounts collect reviews from their customers. These endpoints return them, so you can
show them beside your booking flow. They are not part of making a booking.

## Fetch reviews

```
GET /reviews/?offset={offset}&limit={limit}&stars={stars}
```

Returns the account's reviews, newest first.

**Request**

| Parameter | Required | Description |
| --- | --- | --- |
| `offset` | No | Number of reviews to skip, for paging. Default `0` |
| `limit` | No | Maximum number of reviews to return |
| `stars` | No | Comma separated star ratings to include, for example `4,5` |

```bash
curl "{baseUrl}/reviews/?offset=0&limit=2&stars=3,4,5"
```

**Response 200**

```json
{
  "entries": [
    {
      "reviewRef": "W69R7VNS586GVUWK8",
      "reviewPostedTs": "2025-01-15T16:01:18Z",
      "reviewerName": "Anna L",
      "resourceName": "Bella",
      "stars": 5,
      "reviewText": "Erica was a real champ!"
    },
    {
      "reviewRef": "ER5GM97HKWXEYB2XR",
      "reviewPostedTs": "2023-10-26T13:32:24Z",
      "reviewerName": "Maria S",
      "stars": 5,
      "resourceName": "Lidingö",
      "reviewText": "Loved it! My skin has never been smoother"
    }
  ],
  "limit": 2,
  "offset": 0
}
```

## Fetch review summary

```
GET /reviews/summary
```

Returns the latest reviews together with the star distribution, useful for a
rating badge.

**Response 200**

```json
{
  "entries": [ { "...": "same entry shape as above" } ],
  "reviewSummary": {
    "avgStarRating": 5.0,
    "reviewCount": 3,
    "one": 0,
    "two": 0,
    "three": 0,
    "four": 0,
    "five": 3
  }
}
```