finddoc
Try every endpoint against sandbox data, then a one-time $5 payment unlocks live access — no account needed. Get API access
← v1 API reference

Clinics

View .md

Endpoint

List clinic 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.

GET/api/v1/clinics/{id}/reviews
curl https://www.finddoc.ca/api/v1/clinics/92a39274-7f56-4d18-a93d-ba498508249e/reviews \
  -G \
  -H "Authorization: Bearer fd_sandbox_public_key_2026" \
  -d limit=10
Response200 OK
{
  "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
}

Parameters

ParameterTypeDescription
idrequiredstringClinic id from the path segment.
limitintegerPage size. Defaults to 25, maximum 100.
offsetintegerZero-based offset for pagination. Defaults to 0.

Try it

Sandbox · live request

Runs against the free sandbox key — no sign-in. Results are capped and rate-limited; pay once to unlock the full API.