New Zealand HPI Implementation Guide
1.3.1 - Release

New Zealand HPI Implementation Guide - Local Development build (v1.3.1) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Capability Statement


API summary (generated from the capabilityStatement resource)



This is the computable resource that describes the RESTful endpoint


Practitioner

Practitioner query


Interactions
CodeDocumentation
read

Used to retrieve a Practitioner resource by Id HTTP Request 'GET' Scope required: practitioner:read / Practitioner.r

search-type

Queries against the Practitioner using name and other search parameters. Will return a Bundle (even if there are no matching resources) HTTP Request: 'GET' Scope required: practitioner:search / Practitioner.s

create

Creates a new Practitioner record HTTP Request 'POST' Scope required: practitioner:write / Practitioner.c

Operations
NameDefinitionDocumentation
update-core https:/hpi-ig.hip.digital.health.nz/OperationDefinition/practitioner-update-core

An operation that updates a health providers name, birthdate, death-date HTTP Request 'POST' Scope required: practitioner:write / Practitioner.u

Search Parameters
NameTypeDocumentation
identifier token

For searching a Practitioner resource using their council/board registration number

name string

Should contain the person’s full name, include all given names and family name.

gender token

Use with name and birthdate. Search by gender alone is not allowed.

birthdate date

Use with name and gender. Search by birthdate alone is not allowed.

PractitionerRole

PractitionerRole query


Interactions
CodeDocumentation
read

Used to retrieve a PractitionerRole resource by Id. HTTP Request 'GET' Scope required: pracrole:read / PractitionerRole.r

search-type

Queries against PractitionerRole using hpi-person-id and other parameters. Will return a Bundle (even if there are no matching resources) HTTP Request 'GET' Scope required: pracrole:search / PractitionerRole.s

create

Create a new PractitionerRole HTTP Request 'POST' Scope required: pracrole:create / PractitionerRole.c

update

Update contact details and end date on an existing PractitionerRole record. HTTP Request 'PUT' Scope required: pracrole:write / PractitionerRole.u

Search Parameters
NameTypeDocumentation
practitioner reference

Given an hpi-person-id, returns the PractitionerRole records associated with that id

organization reference

Not yet enabled. Given an hpi-organization-id, returns the PractitionerRole records associated with that id

location token

Given an hpi-facility-id, returns the PractitionerRole records associated with that id

role token

Returns PractitionerRole records based on role code

active token

To enable exclusion of inactive PractitionerRole records

Search includes
Name
practitioner
organization
location
These are the _include parameters that are supported on searches

Organization

Organization query


Interactions
CodeDocumentation
read

Used to retrieve an Organization resource by Id. HTTP Request 'GET' Scope required: organization:read / Organization.r

search-type

Queries against the Organization using name or other parameters. Will return a Bundle (even if there are no matching resources). HTTP Request 'GET' Scope required: organization:search / Organization.s

Search Parameters
NameTypeDocumentation
active token

To enable exclusion of inactive organizations

name string

For searching using the organisation’s name or an alias name

identifier token

For searching using an organisation’s New Zealand Business Number (NZBN) or their legacy NZHIS agency code.

type token

For searching using an organisation's type E.g. DHB, RA, Educational institution

partOf reference

For retrieving organizations that are 'part of' another.

Location

Location query


Interactions
CodeDocumentation
read

Used to retrieve an Location resource by Id. HTTP Request 'GET' Scope required: location:read / Location.r

search-type

Queries against the Location using name or other parameters. Will return a Bundle (even if there are no matching resources). HTTP Request 'GET' Scope required: location:search / Location.s

Search Parameters
NameTypeDocumentation
identifier token

For searching using an organization’s legacy NZHIS facility code.

name string

For searching using the Locations name or alias name

type token

Retrieve Locations of the given type

address string

Retrieve the Locations by address

organization reference

Retrieve Locations with the given ManagingOrganization

dhb token

Searching for Locations that are in a DHBs catchment area.

status token

Not yet enabled. To enable exclusion of inactive locations

messaging-address string

Search by EDI address