Developer Reference for LOINC in FHIR

About

LOINC's FHIR terminology server utilizes HAPI FHIR, the open-source implementation of FHIR in Java. LOINC's instance is built using software provided by Smile CDR.

All requests to LOINC's FHIR terminology server require a LOINC username and password.

BETA

More Info

We also suggest you review HL7's documentation regarding LOINC terminology, 4.2.3 Using LOINC with FHIR. Furthermore, the LOINC Users' Guide can help you understand all the intricacies of the LOINC code system.

You may also post questions and feedback in our User Forum for this server.

Canonical URI for LOINC in FHIR

http://loinc.org

Canonical definition for LOINC as a CodeSystem in FHIR

https://loinc.org/fhir/loinc.xml

REST endpoint base

The following endpoints omit this base for brevity.

https://fhir.loinc.org

CodeSystem endpoint

Returns all information about LOINC as a CodeSystem.

/CodeSystem/?url=http://loinc.org

Identifier lookup operation

May be used on a LOINC term, Part, Answer List, or Answer.

/CodeSystem/$lookup?system=http://loinc.org&code={LOINC identifier}

Lookup specific property

Indicate particular property(ies) for an identifier

/CodeSystem/$lookup?system=http://loinc.org&code={LOINC identifier}&&property={Property}[&&property={Property}]

ValueSet endpoint

Returns entire ValueSet resource including all available value sets, definition criteria, etc.

/ValueSet

Specific ValueSet

Returns the ValueSet resource for the identified Answer List, LOINC Group, or general collection of LOINC terms.

/ValueSet/?url=http://loinc.org/vs/{LOINC identifier}
/ValueSet/{LOINC identifier}

Expand ValueSet operation

Returns the expansion for given ValueSet.

/ValueSet/$expand?url=http://loinc.org/vs/{LOINC ValueSet identifier}

Validate term in given ValueSet

Returns boolean true if term exists in given ValueSet.

/ValueSet/{LOINC ValueSet}/$validate-code?system=http://loinc.org&code={LOINC identifier}

ConceptMap endpoint

Returns all available LOINC concept mappings, metadata, mappings, and canonical URIs.

/ConceptMap

Specific ConceptMap

Returns the ConceptMap resource for identified set.

/ConceptMap/?url={Canonical LOINC ConceptMap URI}

Translate operation

Return available mapping(s) for identified LOINC source term.

/ConceptMap/$translate?system=http://loinc.org&code={LOINC identifier}