SNOMED In 5 Minutes Save

Easy-to-use tutorials for accessing SNOMED APIs within 5 min using various programming languages

Project README

SNOMED In 5 Minutes

This is an easy-to-use tutorial for accessing SNOMED APIs within 5 min using the SNOMED International terminology server, Snowstorm.

Consider using a FHIR API Instead!

The examples in this repository use the Snowstorm native API and although this API is open source it is tool-specific rather than part of a standard.

If possible it's better to use a Terminology Server with a FHIR API because that is an open standard, supported by many server and client implementations in many programming langauges and libraries! Find the FHIR API of the public Snowstorm server here (for non-production use only):

Other terminology servers are available.

Table of Contents

  1. Project Structure
  2. Examples
  3. Resources
  4. Contributing
  5. License

Project Structure

  • top-level: aggregator for sub-modules (alphabetically):

    • android-client-snomed-browser: examples for use in an Android client
    • csharp-examples: examples with csharp (.net)
    • curl-examples: examples with curl
    • java-examples: examples with java
    • javascript-examples: examples with javascript
    • model: JAXB-enabled classes for representing the RF2 domain model
    • php-examples: examples with php
    • python3-examples: examples with python
    • rest-client: a Java client for the REST services
    • rest-client-csharp: a CSharp client for the REST services
    • ruby-examples: examples with Ruby based on the Python examples
    • go-examples: examples with golang


The following examples will be used to demonstrate accessing the SNOMED API through CSharp, Javascript, Curl, and Java (using Jersey).

  • Find a concept by a string (e.g. "heart attack")
  • Find/get a concept by a description SCTID (e.g. "679406011")
  • Find/get a concept by a concept SCTID (e.g. "109152007")
  • Find a concept by a string (e.g. "heart") but only in the Procedures semantic tag

All of the examples use a hard coded URL, edition name, and version number which point to a server hosted by SNOMED International ( These are the APIs that back the SNOMED International browser (

Back to top







Back to top

Needing some TLC

The following examples are out of date and need updating to wokr with Snowstorm. All contributions welcome!

Android client

CSharp (.net)


Further Documentation

Find comprehensive documentation here: TBD


Back to top


  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request

Back to top

Current Contributors

Back to top


Apache 2.0

See the included LICENSE file for details.

Back to top

Suggestions for Future Work

  • 'supporting registration for a British GP' (i.e. searching within the GP/FP reference set & the UK language reference set)
  • 'deriving ICD-10 codes from registered SNOMED concepts (i.e. retrieving all entries of a SNOMED-concept from the ICD-10 extended mapping reference set)
Open Source Agenda is not affiliated with "SNOMED In 5 Minutes" Project. README Source: IHTSDO/SNOMED-in-5-minutes
Open Issues
Last Commit
1 month ago

Open Source Agenda Badge

Open Source Agenda Rating