SNOMED CT terminology service

Clinical information systems and consumer health platforms can be integrated with our new online terminology service to use SNOMED CT

Our new SNOMED CT terminology service is part of the New Zealand Health Terminology Service we are building. We provide the terminology service as a free public good to New Zealand health providers and their industry partners for development and production use in clinical information systems and consumer health platforms.

Under our interoperability roadmap, we will also be introducing terminology services for the New Zealand Pathology Observation Code Sets (NZPOCS) and our other standard code sets.  

The service is available on the internet via a standard FHIR(R) application programming interface (API) at https://snomednz.digital.health.nz/fhir.

The NZ Formulary team is building a FHIR API for access to the NZ Universal List of Medicines and NZ Formulary content.

Using the terminology service

SNOMED International's Snowstorm terminology server is the software used. See the Snowstorm GitHub repository for instructions on using the API.

Here are some examples of its use.

Look up a clinical finding concept https://snomednz.digital.health.nz/fhir/CodeSystem/$lookup?system=http://snomed.info/sct&code=404684003
Look up a procedure concept https://snomednz.digital.health.nz/fhir/CodeSystem/$lookup?system=http://snomed.info/sct&code=427623005
Lookup of medicinal product, including some properties https://snomednz.digital.health.nz/fhir/CodeSystem/$lookup?system=http://snomed.info/sct&code=322236009&property=normalForm&property=sufficientlyDefined
Check if one concept subsumes another https://snomednz.digital.health.nz/fhir/CodeSystem/$subsumes?system=http://snomed.info/sct&codeA=50043002&codeB=195967001
Check if one concept is subsumed by another https://snomednz.digital.health.nz/fhir/CodeSystem/$subsumes?system=http://snomed.info/sct&codeA=195967001&codeB=50043002
Expand an intensionally defined value set using expression constraint language (ECL) https://snomednz.digital.health.nz/fhir/ValueSet/$expand?url=http://snomed.info/sct?fhir_vs=ecl/<<27624003&count=20

Respiratory disorders due to allergic reaction caused by pollen (ECL)

https://snomednz.digital.health.nz/fhir/ValueSet/$expand?url=http://snomed.info/sct?fhir_vs=ecl/< 50043002 |Disorder of respiratory system (disorder)| : << 42752001 |Due to (attribute)| = << 418364006 |Allergic reaction caused by pollen (disorder)|

Medicinal products containing caffeine

https://snomednz.digital.health.nz/fhir/ValueSet/$expand?url=http://snomed.info/sct?fhir_vs=ecl/< 763158003 |Medicinal product (product)| : << 127489000 |Has active ingredient (attribute)| = << 255641001 |Caffeine (substance)|

Expand an intensionally defined value set using the is-a relationship https://snomednz.digital.health.nz/fhir/ValueSet/$expand?url=http://snomed.info/sct?fhir_vs=isa/27624003&count=20
Filter an ECL value set on a clinical term

https://snomednz.digital.health.nz/fhir/ValueSet/$expand?url=http://snomed.info/sct?fhir_vs=ecl/<< 763158003&filter=aspirin

Validate a code against an implicit value set, also checking the display term https://snomednz.digital.health.nz/fhir/ValueSet/$validate-code?url=http://snomed.info/sct?fhir_vs=ecl/<< 34014006&code=840539006&display=COVID-19
List all SNOMED concepts mapped to ICD-O https://snomednz.digital.health.nz/fhir/ValueSet/$expand?url=http://snomed.info/sct?fhir_vs=ecl/^446608001&count=20
List all New Zealand simple reference sets https://snomednz.digital.health.nz/MAIN/SNOMEDCT-NZ/concepts?ecl=< 50501000210100
List the emergency department chief presenting complaint refset

https://snomednz.digital.health.nz/fhir/ValueSet/$expand?url=http://snomed.info/sct/21000210109?fhir_vs=refset/71000210108&count=10

List the emergency department diagnosis refset https://snomednz.digital.health.nz/fhir/ValueSet/$expand?url=http://snomed.info/sct/21000210109?fhir_vs=refset/61000210102&count=10
List the emergency department procedure refset https://snomednz.digital.health.nz/fhir/ValueSet/$expand?url=http://snomed.info/sct/21000210109?fhir_vs=refset/321000210102&count=10

Contact us

Email us at [email protected] for more information

Back to top