In the Snowstorm native API a code system is an Edition or Extension of the SNOMED CT terminology. A list of available code systems can be fetched using GET /codesystems
.
Code systems have:
- a Short Name
- Examples: SNOMEDCT, SNOMEDCT-US, SNOMEDCT-DK
- a Working Branch
- Examples: "MAIN", "MAIN/SNOMEDCT-US", "MAIN/SNOMEDCT-DK"
N.B. Working branches should NOT be used to access versioned content. Content in the working branch should not be relied upon; this branch can contain daily-build content, that has not yet been published and is subject to change or deletion.
Versioned content should be accessed using a code system version branch.
The code system response includes details of the latest code system version latestVersion > branchPath
. Examples: "MAIN/2021-07-31", "MAIN/SNOMEDCT-NZ/2021-10-01".
The loaded versions of a code system can be listed using GET /codesystem/{shortName}/versions
.
If content is loaded into Snowstorm before the publication date by default it will not be shown as the latest version of the code system, until the effectiveDate matches the
date on the server. This behaviour can be changed using the configuration flag codesystem.all.latest-version.allow-future
.
Similarly the code system versions listing will not display future dated versions unless the showFutureVersions=true
parameter is included in the request.