CodeSystem

Code systems maintained within Snow Owl are exposed (read-only) via the endpoints /CodeSystem and /CodeSystem/{codeSystemId}. Supported concept properties are handled and returned if requested. The currently exposed code systems are:

Snow Owl OSS:

• SNOMED CT

• Internal (FHIR) Code Systems (terminology subset)

Snow Owl Pro:

• ATC

• ICD-10

• LOINC

• OPCS

• Local Code Systems

SNOMED CT

All standard and default SNOMED CT properties are supported, including the relationship type properties. In addition to the FHIR SNOMED CT properties, Snow Owl can return the effective time property, with the URI http://snomed.info/field/Concept.effectiveTime.

Operations

$lookup

Both GET as well as POST HTTP methods are supported. Concepts are queried based on code, version, system or Coding. Designations are included as part of the response as well as supported concept properties when requested. No date parameter is supported.

Example for looking up a code from the Issue-type FHIR code system:

 /CodeSystem/$lookup?system=http://hl7.org/fhir/issue-type&code=login&_format=json

Example for looking up properties (inactive and method) of the latest version of a SNOMED CT procedure by method code:

 /CodeSystem/$lookup?system=http://snomed.info/sct&code=128927009&_format=json&property=inactive&property=http://snomed.info/id/260686004

For SNOMED CT, all common and SNOMED CT properties are supported, including all active relationship types.

$validate-code

Both GET as well as POST HTTP methods are supported for all exposed terminologies. Example for validating a SNOMED CT code:

/CodeSystem/SNOMEDCT/2020-02-04/$validate-code?code=128927009

$subsumes

Both GET as well as POST HTTP methods are supported. Subsumption testing is supported for ICD-10 and SNOMED CT terminologies.

Example for SNOMED CT (version 2018-01-31):

/CodeSystem/$subsumes?codeA=409822003&codeB=264395009&system=http://snomed.info/sct/900000000000207008/version/20180131