# List clinics

`GET https://www.finddoc.ca/api/v1/clinics`

Return clinics filtered by acceptance, languages, accessibility, and location. Results are sorted by distance when `lat` and `lng` are supplied, otherwise by name.

## Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| specialties | string | No | Comma-separated specialties to match, e.g. `Family Medicine,Pediatrics`. |
| accepting | boolean | No | When true, only return rows currently accepting new patients. |
| gender | string | No | One of "male", "female", or "non-binary". |
| languages | string | No | Comma-separated list of languages spoken, e.g. `English,French`. |
| minYears | integer | No | Minimum years of practice for the doctor. |
| maxYears | integer | No | Maximum years of practice for the doctor. |
| evening | boolean | No | Only include clinics with evening hours (after 5 PM). |
| weekend | boolean | No | Only include clinics open on Saturday or Sunday. |
| wheelchair | boolean | No | Only include wheelchair-accessible clinics. |
| virtualVisits | boolean | No | Only include clinics offering virtual visits. |
| nearTTC | boolean | No | Only include clinics near a TTC subway station. |
| lat | number | No | Latitude for distance sort. Must be paired with `lng`. |
| lng | number | No | Longitude for distance sort. Must be paired with `lat`. |
| 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 \
  -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d accepting=true \
  -d languages=French \
  -d limit=10
```

## Example response (200 OK)

```json
{
  "clinics": [
    {
      "id": 92a39274-7f56-4d18-a93d-ba498508249e,
      "name": "Riverdale Family Health",
      "address": "123 Queen St E, Toronto, ON",
      "accepting": true,
      "languages": ["English", "French"],
      "specialties": ["Family Medicine"],
      "lat": 43.659,
      "lng": -79.358
    }
  ],
  "total": 42,
  "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.