# List doctors

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

Return doctors filtered by specialty, languages, gender, and years of practice. Each item embeds the doctor's primary `clinic` and a `dataFreshness` marker.

## Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| specialties | string | No | Comma-separated specialties to match, e.g. `Cardiology,Pediatrics`. A doctor matches if they hold any of them. |
| specialty | string | No | Single specialty to match, e.g. `Family Medicine`. Singular and exact. Kept for compatibility — `specialties` wins when both are sent. |
| 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. |
| 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/doctors \
  -G \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "specialty=Family Medicine" \
  -d accepting=true \
  -d languages=French \
  -d limit=10
```

## Example response (200 OK)

```json
{
  "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
}
```

---

## 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.