Is this LOINC FHIR Terminology Server Implementation FOSS?

Home Forums LOINC FHIR Terminology Server Is this LOINC FHIR Terminology Server Implementation FOSS?

Viewing 8 posts - 1 through 8 (of 8 total)
  • Author
  • #447540
    Manisha Mantri


    Is this LOINC Server implementation a FOSS? I mean can one deploy it locally/regionally for integration?

    Manisha Mantri

    I can see its a HAPI implementation. But I wanted to know if any changes needed/done to set-up LOINC files in it.

    Tim Briscoe

    Hi, Manisha. Our terminology server uses SmileCDR, the commercial product that uses the open-source HAPI-FHIR as its backend. The tooling we use to update LOINC terminology is available for anyone to use within HAPI-FHIR. Once you stand up your HAPI-FHIR instance, you can use its upload-terminology command in conjunction with the LOINC zip file you download from our site. For example:

    ./hapi-fhir-cli upload-terminology -d Downloads/ -f dstu3 -t http://localhost:8080/baseDstu3 -u

    Documentation is available at

    I hope this helps! Keep us informed of your progress and let us know if you need additional assistance.

    Aitor Perez


    Just trying to upload the latest LOINC terminology file ( to my local HAPI FHIR server using hapi-fhir-cli command but seems is missing some needed files (MultiAxialHierarchy.csv)

    This is the error:

    HTTP 422 Unprocessable Entity: HAPI-0862: Could not find the following mandatory files in input: [AccessoryFiles/MultiAxialHierarchy/MultiAxialHierarchy.csv]

    Checking the ZIP content, this file doesn’t exists.

    I’m doing something wrong? Or latest LOINC releases are not compatible any more with this HAPI FHIR command line tool ?

    Thanks in advance

    Tim Briscoe

    Hello Aitor,

    Yes, we have renamed this hierarchy and its associated artifact. In your HAPI-FHIR server, you should have a file named Within it, you should be able to change the file name for this artifact as so:

    # LOINC hierarchy
    ## Default value if key not provided: AccessoryFiles/MultiAxialHierarchy/MultiAxialHierarchy.csv
    ## File must be present

    We’ll see if we can have HAPI-FHIR make this change at the source so others do not run into this issue.

    Shantanu Banerjee

    Hi Team,

    I am using HAPI JPA FHIR server version 6.2.1 (latest pull from master branch).

    I was getting the above issue (about <span style=”background-color: #fbfbfb; font-family: Lato, Helvetica, Arial, Lucida, sans-serif; font-size: 15.6px;”>MultiAxialHierarchy.csv)</span>  and following your instruction created a file

    names in src/main/resources folder and built and ran the server.

    However I am still getting the error. Where am I going wrong? Where should I create the file?


    Thanks in advance.

    Tim Briscoe

    Hello Shantanu,

    My implementation uses SmileCDR rather than HAPI so the structure may be slightly different. Of course SmileCDR is more or less the same as HAPI but it’s worth noting.

    Here’s the structure we have:


    Where is a script which calls the smileutil tool. The script passes the necessary parameters to update the terminology based on the input file. Your port number will probably vary.

    ../../bin/smileutil upload-terminology -v r4 -t http://localhost:18999/ -u -b “user:pass” -l -d -d

    Documentation on smileutil is at

    Again, HAPI/Smile doesn’t know to look for the new artifact name so that’s why you need to update the referenced file in Should HAPI not have such a properties file, you can alternatively rename the artifact within the zip to MultiAxialHierarchy.csv.

    I hope this helps. Keep us updated on your progress.

    Shantanu Banerjee

    Thanks Tim,

    Your suggestion above correct . We have to use it with as a parameter (with -d option). I used the below command and it worked. The path names may vary for others

    hapi-fhir-cli upload-terminology -d -d -v r4 -t http://localhost:8080/fhir -u

    Thanks again


Viewing 8 posts - 1 through 8 (of 8 total)
  • You must be logged in to reply to this topic.