# List clinic reviews

`GET https://www.finddoc.ca/api/v1/clinics/{id}/reviews`

Paginated reviews for a clinic, addressed by id in the path, with an `aggregate` block: the average rating, total count, and a per-dimension breakdown. A clinic with no reviews returns `avgRating: null` and zero counts. Unknown ids return `404 not_found`.

## Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| id | string | Yes | Clinic id from the path segment. |
| limit | integer | No | Page size. Defaults to 25, maximum 100. |
| offset | integer | No | Zero-based offset for pagination. Defaults to 0. |

## Example request

```bash
curl https://www.finddoc.ca/api/v1/clinics/92a39274-7f56-4d18-a93d-ba498508249e/reviews \
  -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d limit=10
```

## Example response (200 OK)

```json
{
  "clinicId": "92a39274-7f56-4d18-a93d-ba498508249e",
  "aggregate": {
    "avgRating": 4.3,
    "count": 27,
    "byDimension": [
      {
        "dimension": "wait_time",
        "avgRating": 3.9,
        "count": 21
      },
      {
        "dimension": "staff",
        "avgRating": 4.6,
        "count": 24
      }
    ]
  },
  "reviews": [
    {
      "author": "Priya S.",
      "rating": 5,
      "text": "Front desk was friendly and the wait was short.",
      "date": "2026-03-22"
    }
  ],
  "total": 27,
  "count": 1
}
```

---

## Get full access

Direct v1 API access is unlocked by a one-time payment — One Time Payment (Early Access) (5 CAD). Complete checkout at https://www.finddoc.ca/developers/checkout.