← v1 API reference
Specialists
Endpoint
List specialists
Return specialists for a given specialty. Filters mirror /clinics; the response uses the same shape so the same client can render both.
GET/api/v1/specialists
curl https://finddoc-ten.vercel.app/api/v1/specialists \
-G \
-H "Authorization: Bearer fd_test_xxxx…" \
--data-urlencode "specialty=Family Medicine" \
-d languages=FrenchResponse200 OK
{
"clinics": [
{
"id": "specialist_3qm71v",
"name": "Dr. Amelie Tremblay",
"specialty": "Family Medicine",
"languages": ["English", "French"],
"accepting": true,
"wait_weeks": 6
}
],
"total": 12,
"count": 1
}Parameters
| Parameter | Type | Description |
|---|---|---|
| specialtyrequired | string | Single specialty to match, e.g. Family Medicine. Returns 400 missing_param if omitted. |
| accepting | boolean | When true, only return rows currently accepting new patients. |
| gender | string | One of "male", "female", or "non-binary". |
| languages | string | Comma-separated list of languages spoken, e.g. English,French. |
| minYears | integer | Minimum years of practice for the doctor. |
| maxYears | integer | Maximum years of practice for the doctor. |
| evening | boolean | Only include clinics with evening hours (after 5 PM). |
| weekend | boolean | Only include clinics open on Saturday or Sunday. |
| wheelchair | boolean | Only include wheelchair-accessible clinics. |
| virtualVisits | boolean | Only include clinics offering virtual visits. |
| nearTTC | boolean | Only include clinics near a TTC subway station. |
| lat | number | Latitude for distance sort. Must be paired with lng. |
| lng | number | Longitude for distance sort. Must be paired with lat. |
| limit | integer | Page size. Defaults to 25, maximum 100. |
| offset | integer | Zero-based offset for pagination. Defaults to 0. |
Try it
Live requestSign in with Google — first sign-in creates your free FindDoc account to run live requests against your account's rate limit.