HL7 FHIR Implementation Guide - New Zealand Formulary/NZULM IG
0.1.0 - ci-build
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
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.)
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
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