# Doctor summary

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

Directory-wide totals: the doctor count, how many are accepting new patients, a per-specialty breakdown, and a `dataFreshness` coverage rollup. Takes no query parameters.

## Example request

```bash
curl https://www.finddoc.ca/api/v1/doctors/summary \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Example response (200 OK)

```json
{
  "totalDoctors": 4821,
  "acceptingNewPatients": 1163,
  "bySpecialty": [
    {
      "specialty": "Family Medicine",
      "count": 2104
    }
  ],
  "dataFreshness": {
    "fresh": 4200,
    "stale": 540,
    "unknown": 81,
    "coveragePct": 98.3
  }
}
```

---

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