# List specialists

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

Return specialists for a given `specialty`. Filters mirror `/clinics`; the response uses the same shape so the same client can render both.

## Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| specialty | string | Yes | Single specialty to match, e.g. `Family Medicine`. Returns `400 missing_param` if omitted. |
| 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/specialists \
  -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "specialty=Family Medicine" \
  -d languages=French
```

## Example response (200 OK)

```json
{
  "clinics": [
    {
      "id": "specialist_3qm71v",
      "name": "Dr. Amelie Tremblay",
      "specialty": "Family Medicine",
      "languages": ["English", "French"],
      "accepting": true,
      "wait_weeks": 6
    }
  ],
  "total": 12,
  "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.