Introduction

This page describes the subset of the FHIR RESTful API supported by healthAllliance against the data sources of the hospitals it manages.

It does not include the authentication and other security requirements

Patient

Queries that allow individual patients to be returned.

The Companion application has a query tool that can be used.

Search by Demographics

Returns a bundle with matching patients. Elements supported:

• name
• birthDate
• gender
• identifier

(there are likely some mandatory elements...)

GET [host]/Patient?name={x}&birthDate={y}...

See the spec for details on the searches

Specific queries

Search by name

Returns a bundle of patients with matching names. There will very likely be more than one.

Patient?name={name}

eg

Patient?name=smith

Note that the name query will match any of the string fields in the HumanName, including family, given and/or text

Search by NHI

Returns a bundle of patients with matching NHI's. There may be more than one.

GET [host]/Patient?identifier={nhi}

eg

Patient?identifier=https://standards.digital.health.nz/id/nhi|ABC1234

Note that the identifier query (whch is of type token) should include the 'system' (or namespace) of the NHI

Included resources

It is possible to return resources that are referenced by the matching resource in the same query ising the _include parameter.

For example the following query will return all patients whose name is 'smith' and include the references resources for general practitioner and organization.

Patient?name=smith&_include=Patient:general-practitioner&_include=Patient:organization