medicalcouncil.org.nz APImedicalcouncil.org.nz ↗
Search and retrieve registered doctor profiles from the Medical Council of New Zealand public register, including qualifications, specialty, and scope of practice.
curl -X GET 'https://api.parse.bot/scraper/1c6e1494-adcf-4bf9-938f-637c95443b45/search_doctors?start=0&keyword=Smith&location=auckland' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for doctors in the public register with various filters. Returns up to 20 results per page, with pagination via the start parameter.
| Param | Type | Description |
|---|---|---|
| area | string | Area of medicine slug from get_register_metadata areas_of_medicine (e.g. 'general-practice', 'emergency-medicine'). |
| start | integer | Pagination offset in multiples of 20. |
| status | string | Registration status slug from get_register_metadata statuses (e.g. 'practising', 'not-practising', 'inactive', 'suspended'). |
| keyword | string | Search by doctor name or keyword. |
| location | string | Location slug from get_register_metadata locations (e.g. 'auckland', 'christchurch'). |
{
"type": "object",
"fields": {
"count": "integer number of doctors returned in this page",
"start": "integer pagination offset used",
"doctors": "array of doctor summary objects with name, slug, url, location, specialty, status, practising_certificate_expiry",
"total_results": "integer total number of matching doctors"
},
"sample": {
"data": {
"count": 20,
"start": 0,
"doctors": [
{
"url": "https://www.mcnz.org.nz/registration/register-of-doctors/doctor/smith-abigail-mary/",
"name": "Smith, Abigail Mary",
"slug": "smith-abigail-mary",
"status": "Practising",
"location": "Auckland",
"specialty": "General Practice",
"practising_certificate_expiry": "31 May 2027"
}
],
"total_results": 203
},
"status": "success"
}
}About the medicalcouncil.org.nz API
The MCNZ Register API provides 3 endpoints for searching and retrieving doctor profiles from the Medical Council of New Zealand's public register. The search_doctors endpoint accepts filters for name, location, specialty, and registration status, returning up to 20 results per page. The get_doctor_details endpoint returns structured profile data including qualifications, scope of practice dates, and any conditions on registration.
What the API covers
The API exposes the Medical Council of New Zealand's public register of doctors across three endpoints. search_doctors accepts a keyword (name or free text), a location slug (e.g. auckland, christchurch), an area slug for specialty (e.g. general-practice, emergency-medicine), a status slug (e.g. practising, not-practising, inactive), and a start integer for paginating through results in multiples of 20. Each result in the doctors array includes the doctor's name, URL slug, location, specialty, status, and practising certificate expiry date.
Doctor detail profiles
get_doctor_details accepts a slug from search results and returns the full profile: name, status, location, specialty, conditions on registration, general_scope and provisional_scope award dates, and a qualifications array where each entry has a title and details field. This makes it straightforward to verify whether a practitioner holds a specific qualification or has conditions attached to their registration.
Filter values and register metadata
get_register_metadata takes no inputs and returns the canonical lists of valid filter slugs: locations, areas_of_medicine, and statuses, each as arrays of value/label pairs. It also returns a last_updated string indicating when the register was last refreshed. Always call this endpoint first when building a filter UI or constructing parameterised searches against search_doctors, since slug values can change as the council updates its taxonomy.
- Verify a doctor's current registration status and practising certificate expiry before a referral or appointment
- Build a practitioner directory filtered by specialty and location for a patient-facing healthcare platform
- Monitor for changes in registration conditions on a set of practitioner slugs over time
- Aggregate qualification data across a cohort of doctors for workforce research
- Cross-check a submitted CV's stated qualifications against the official MCNZ register
- Populate autocomplete search for NZ doctors by name using the keyword filter in search_doctors
- Audit whether practitioners in a clinic roster hold general or provisional scope of practice
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.