LOINC – IVD Test Code (LIVD) Mapping
0.3.0 - ballot

LOINC – IVD Test Code (LIVD) Mapping, published by HL7 International - Orders and Observations Work Group. This is not an authorized publication; it is the continuous build for version 0.3.0). This version is based on the current content of https://github.com/HL7/livd/ and changes regularly. See the Directory of published versions

LIVD Data Definitions

The following provides the specific definitions for each of the data elements relevant to LIVD.

We encourage the use of GUIDs (Globally Unique IDentifier) for identifiers to enable consumers and aggregators of LIVD Catalogs to easily merge and identify duplicates.

LIVD Publication

This information that describes the overall LIVD publication is expressed through the LIVD Catalog profile, including:

  • Publisher is the entity publishing the mapping information.
  • Publication Version ID is human-readable information provided by the vendor that can be used to differentiate LIVD Publication versions.
  • LOINC Version ID is the version of LOINC that was used for the mapping.
  • The LOINC License requires a statement of attribution and notice that LOINC content is copyrighted.
  • LOINCCopyright component holds the required attribution statement.
  • Localization is the language used for this LIVD Publication.
  • Region is an optional vendor description for which geographic or administrative region this localization is valid, e.g. de-CH (German (Switzerland)) is self-explanatory, but not en-CH (English (Switzerland)).


The equipment elements are expressed through the LIVD Device Definition profile, including:

  • Manufacturer is the name of the manufacturer of the device.
  • Model is the model of the device as provided by the manufacturer.
  • UID is the unique device identifier, that may be the one used in the Unique Device Identifier (UDI) constructs.
  • UID Type is capable of supporting the unique device identification system to identify medical devices through their distribution and use. When fully implemented, the label of most devices will include a unique device identifier (UDI) in human- and machine-readable form.

Note that types and cardinality are aligned with values reported in the Integrating the Healthcare Enterpires (IHE) Laboratory Analytical Workflow (LAW) Profile OBX-18 Equipment Instance Identifier.

IVD Tests

The IVD Test attributes are aligned with obvservation definition attributes and expressed using the LIVD Observation Definition profile.

  • Vendor Analyte Code is one of two possible values:
    • For an automated test result, it contains Vendor Transmission Code used by the instrument when sending the test result to a health information system, such as an LIS.
    • For a manual test result, it is the Vendor Analyte Identifier for the test result produced by the Test Kit.
  • Vendor Analyte Name is human-readable text the vendor used to identify the analyte. The text might be displayed by the instrument or could be used within an assay insert.
  • Vendor Reference ID is an additional vendor identifier, such as an identifier that can be used to locate the associated assay insert published by the vendor.

Additionally, various details on the Observation Definition that can aid in the mapping from the IVD Test’s Vendor Analyte Code to a LOINC are included as optional attributes, even though not referenced in the original IICC white paper.

IVD Test - LOINC Mapping

The potential mappings of the IVD Test’s Vendor Analyte Code to LOINC code are captured in the LIVD Test Code Concept Map profile. For each IVD Test’ Vendor Analyte Code and a suggested LOINC code, the following attributes are captured.

  • Vendor Specimen Description is human-readable text that provides information about the specimen used for the test, such as “Serum or Plasma.” The field is used to document the vendor description of the specimen used for the IVD test.
  • Vendor Result Description is human-readable text that provides information about the result that is produced.
    • For non-numeric results, this field should describe the result by including one of the following:
      • Binary – pos/neg, reactive/non-reactive.
      • Ordinal – none, few, many.
      • Nominal – the test can report none found or one or more possibilities from a taxonomy of choices, such as organism names.
    • Numeric results and associated units of measure:
      • For numeric results, this field should describe the result by including a representative unit of measure, preferably represented as a UCUM unit.
      • If one unit of measure is reported, then include it in this field.
      • If multiple units can be reported that can be converted to one another by a multiplicative scale factor independent of the analyte (such as mg/L and ug/dL), select one of the units as a representative unit.
      • If multiple units can be reported that cannot be converted by an analyte-independent scale factor (such as mol/L and as mg/L), then define a mapping for each unit. These different types of numeric results require their own LOINC codes – one for the test reported as molar concentration and one for the test reported as mass concentration. Similarly, the results of a urine analyte (e.g. Sodium) reported as either mmol/L (spot urine) versus mmol/(24.h) (24 hour urine) have different LOINC properties and map to two different LOINC codes. The same is true for viral loads which can be reported in units of copies/mL, Log (copies/mL), IU/mL and Log (IU)/mL; and none of which can be converted by a simple scale factor. These result types have different properties and thus different LOINC codes. In such cases, define a mapping for all units that are appropriate for this IVD test.
      • In some cases, the same IVD Test may be reported as a Binary result, or a spot numeric result of the mass concentration, etc. In such instances, the same LIVD Test will map to multiple LOINCs. The Vendor Result Description should be used to assist the laboratory in manually selecting the appropriate LOINC for their laboratory.
  • Vendor Comment is human-readable text clarification, such as “This is a STAT (prioritized) version of the test”.

Note that Vendor Specimen Description, Vendor Result Description, and Vendor Comment are included to assist a laboratory in selecting the appropriate LOINC code(s) for the vendor IVD tests used by the laboratory. This information is not intended to be parsed by an IVD Software System that automates the mapping of vendor IVD transmission codes to LOINC codes. The inclusion of this information should reduce errors in the manual selection of LOINC codes by a laboratory.

LOINC Code System

For each of the LOINC codes being considered, a minimum set from the code system is included to further aid in the mapping process. These are included in the LIVD LOINC Fragment CodeSystem profile.

  • LOINC Code
  • LOINC Long Name
  • Component
  • Property
  • Time
  • System
  • Scale
  • Method

Sample Data

As part of defining the whitepaper, IICC also developed a spreadsheets that contains the relevant data and a potential representation of that data that can be found here.