Skip to content
📚 Optimized search system for SNOMED CT & ICD API
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Snomed logo


Architecture Status Tests Coverage
Ubuntu Trusty 14.04 x86_64 Build Status codecov

Welcome to snoicd-codex

Snoicd codex is a REST service build for resolving and mapping the codes in SNOMED CT and ICD terminologies. It helps developers to step over the gap that exists between those two terminologies.

It is build on top of a reduced version of the SNOMED CT database and UMLS map files for ICD-9 and ICD-10.

Getting started

These instructions give the most direct path to work with this module.

System Requirements

As the project is developed in java macOS, Windows and Linux distributions are natively supported. Of course you will need the latest JDK available and haveing Docker installed on your computer. Also, depending on where are you going to run the database, you will need internet connection or MongoDB installed and running on your machine.

Java Development Kit (JDK) ⚠️ No support for java 10 nor 11 ⚠️

A Java Development Kit (JDK) is a program development environment for writing Java applets and applications. It consists of a runtime environment that "sits on top" of the operating system layer as well as the tools and programming that developers need to compile, debug, and run applets and applications written in the Java programming language.

If you do not has the latest stable version download you can download it here.


Docker provides container software that is ideal for developers and teams looking to get started and experimenting with container-based applications. It can be downloaded here for your favourite OS.

Deploying snoicd-codex

These instructions give the most direct path to a working snoice-codex. First thing to do is to clone the repository on to your local computer, for that:

git clone

Then you will need to change your working directory to the snoicd-codex, build the api sources and finally deploy the docker container, to do so:

cd snoicd-codex;
cd api;
mvn package -DskipTests;
cd ..;
docker-compose up;

Notice that once the docker-compose services start it will take between 1 and 5 minutes for services to start. Once the services started you will be able to connect at http://localhost:8082. Find more information about the API here. This API has been documented with Swagger 2 so at http://localhost:8082/swagger-ui.html you can try / test the behaviour of the endpoint.

Did you find an issue?

If you find any issue or have any doubt with the system just ask by submitting an issue.

Versions included

Terminology Version Internal code
ICD-9 icd9
ICD-10 icd10
SNOMED CT snomed
You can’t perform that action at this time.