HL7 FHIR Implementation Guide - New Zealand Formulary/NZULM IG, published by New Zealand Medicines Formulary LP. This is not an authorized publication; it is the continuous build for version 0.1.0). This version is based on the current content of https://github.com/HL7NZ/nzf/ and changes regularly. See the Directory of published versions

Example Queries

Example queries

WIP - the intention of this page is to detail common use cases, ranging from the simple retrieval of resources to best practice for using that data (e.g. for interactions checking etc.)

Medications

Get a list of all medications

[base]/Medication

Get a specific medication based on sctid

[base]/Medication/44282231000116104

Get a specific medication based on sctid via code - returns a bundle

[base]/Medication?code=44282231000116104

Get a specific medication based on sctid via Pharmacode® (only applies to CTPPs) - returns a bundle

[base]/Medication?code=393924

Get a specific medication based on sctid via GTIN - returns a bundle

[base]/Medication?code=https://www.gs1.org/gtin

09322838012989

Get medications that have been updated since 1 Apr 2021 (can be useful for maintaining a local cache)

[base]/Medication?_lastUpdated=gt2021-04-01

Get list of medications that contain ibuprofen (MP)

[base]/Medication?ingredient-code=10013251000116106

Get list of medications that contain ibuprofen (substance)

[base]/Medication?ingredient-code=2211011000036101

Get list of all active medications (based on the formulary criteria - see mappings for criteria )

[base]/Medication?status=active

Get list of medication based on nzmt type

[base]/Medication?nzf-nzmt-type=mpuu [base]/Medication?nzf-nzmt-type=https://standards.digital.health.nz/ns/nzmt-type-code|mpuu

Get a medication with the nzf-link document references included (this can be used to retrieve the references to the available monographs)

[base]/Medication?code=10346001000116101&_include=Medication:nzf-link

Search for a medication based on part of the preferred term (other string based search options can be used on this search parameter)

[base]/Medication?nzf-preferred-term:contains=purified

Search for a CTPP medication based on part of the preferred term (other string based search options can be used on this search parameter)

[base]/Medication?nzf-preferred-term:contains=purified&nzf-nzmt-type=ctpp

Get list of medications based on related medications

[base]/Medication?nzf-related-medication=10044651000116102

Get a list of TPUUs based on related medications (MPUU)

[base]/Medication?_elements=code&nzf-related-medication=10044651000116102&nzf-nzmt-type=tpuu

Document references

To get a list of all types of document references then they can be filtered by type e.g.

[base]/DocumentReference?type=https://standards.digital.health.nz/ns/nzf-document-type-code|[Code]

Get a list of all NZF monographs (Adult monographs)

[base]/DocumentReference?type=https://standards.digital.health.nz/ns/nzf-document-type-code|AdultMonograph [base]/DocumentReference?type=AdultMonograph

Get a list of all NZFC monographs (Child monographs)

[base]/DocumentReference?type=https://standards.digital.health.nz/ns/nzf-document-type-code|ChildMonograph [base]/DocumentReference?type=ChildMonograph

Get a list of medications that are contained in a monograph

[base]Medication?nzf-link-type=DocumentReference/a8e50e23-773a-46d5-8f38-544b0dc89857&_elements=code

Get a list of all Datasheets

[base]/DocumentReference?type=https://standards.digital.health.nz/ns/nzf-document-type-code|Datasheet [base]/DocumentReference?type=Datasheet

Get a list of all CMIs

[base]/DocumentReference?type=https://standards.digital.health.nz/ns/nzf-document-type-code|CMI [base]/DocumentReference?type=CMI

Get a list of all Patient Information Leaflets

[base]/DocumentReference?type=https://standards.digital.health.nz/ns/nzf-document-type-code|PIL [base]/DocumentReference?type=PIL

Get a Patient Information Leaflet for a given MP (this includes all document references - these will need to be filtered on return)

[base]/Medication?code=10037191000116105&_include=Medication:nzf-link