New Zealand HPI Implementation Guide
0.9.0 - CI Build

New Zealand HPI Implementation Guide, published by Ministry of Health. This is not an authorized publication; it is the continuous build for version 0.9.0). This version is based on the current content of and changes regularly. See the Directory of published versions


The HPI has HealthLink addresses recorded against HPI Facilities (Location). These can be extracted from Location.telecom EDI extension.

See here for more details.

What if I know a person’s medical council number but not their HPI number, can I still access their details?

Yes, use a query practitioner with another identifier. See here for more details

Where do I find a practitioners Practising Certificate dates?

A practitioner’s Practising Certificate (also known as an Annual Practising Certificate or APC) is returned in the HpiPractitioner.qualification.period attribute. It is the most recent practising period supplied by the RA. The APC period may be in the past or start in the future. The registration status as well as the APC should be assessed when determining a practitioner’s authority to practice. The registration status should be current and todays date should lie within the qualification.period. Registration status of inactive, removed or suspended should be treated as exceptions.

What if a Practitioner retires, what will their record look like?

If a practitioner has retired and asked to be removed from the register their registration status will be ‘removed’.

Can I do bulk look ups of many practitioners at a time?

There is no bulk operation supported at this time. However, the Practitioner Read by Id has a good response time and the HPI is designed to cope with high loads. If you need to send bulk requests or process high volumes, please contact us to discuss.