← v1 API reference
Doctors
Endpoint
List doctors
Return doctors filtered by specialty, languages, gender, and years of practice. Each item embeds the doctor's primary clinic and a dataFreshness marker.
GET/api/v1/doctors
curl https://www.finddoc.ca/api/v1/doctors \
-G \
-H "Authorization: Bearer fd_sandbox_public_key_2026" \
--data-urlencode "specialty=Family Medicine" \
-d accepting=true \
-d languages=French \
-d limit=10Response200 OK
{
"doctors": [
{
"id": "doctor_5h7m2k",
"cpsoNumber": "90123",
"name": "Dr. Amelie Tremblay",
"gender": "female",
"yearsOfPractice": 12,
"specialties": ["Family Medicine"],
"languages": ["English", "French"],
"clinic": {
"id": 92a39274-7f56-4d18-a93d-ba498508249e,
"name": "Riverdale Family Health",
"address": "123 Queen St E, Toronto, ON",
"lat": 43.659,
"lng": -79.358,
"phone": "+1 416-555-0142",
"acceptingNewPatients": true
},
"dataFreshness": "fresh",
"syncedAt": "2026-05-01T09:30:00Z"
}
],
"total": 318,
"count": 1
}Parameters
| Parameter | Type | Description |
|---|---|---|
| specialties | string | Comma-separated specialties to match, e.g. Cardiology,Pediatrics. A doctor matches if they hold any of them. |
| specialty | string | Single specialty to match, e.g. Family Medicine. Singular and exact. Kept for compatibility — specialties wins when both are sent. |
| 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. |
| limit | integer | Page size. Defaults to 25, maximum 100. |
| offset | integer | Zero-based offset for pagination. Defaults to 0. |
Try it
Sandbox · live requestRuns against the free sandbox key — no sign-in. Results are capped and rate-limited; pay once to unlock the full API.