Genomics Reporting Implementation Guide
2.0.0 - CI Build

Genomics Reporting Implementation Guide, published by HL7 International Clinical Genomics Work Group. This is not an authorized publication; it is the continuous build for version 2.0.0). This version is based on the current content of and changes regularly. See the Directory of published versions

IG Home Page

This implementation guide is not fully complete. Portions of the implementation guide are provided for "framework purposes only" - giving a sense of what additional topics are intended to be covered and where that content will fit. The work group has prioritized standardizing those portions of the specification with general applicability and related to sequencing. At this time, the work group has not yet come to a consensus on a single minimal set of elements that are required to be supported for generic use cases. In a future release, specific lab reporting use cases will have individual capability statements including must-support elements. The work group will continue to flesh out additional sections for future ballot publications.


Genomics is a rapidly evolving area of healthcare that involves complex data structures. There is significant value in sharing this information in a way that is consistent, computable and that can accommodate ongoing evolution of medical science and practice. The value comes from the ability to easily sort, filter and perform decision support on such information and the resulting improvements in care and reduction in costs such as the elimination of redundant testing. The implementation guide is also transmission protocol-independent - the data structures presented here could be used in RESTful, messaging, document or other paradigms.

This guide covers all aspects of human genomic genomics-reporting, including:

  • Representation of simple discrete variants, structural variants including copy number variants, complex variants as well as gross variations such as extra or missing chromosomes
  • Representation of both known variants as well as fully describing de novo variations
  • Germline and somatic variations
  • Relevance of identified variations from the perspective of disease pathology, pharmacogenomics, transplant suitability (e.g. HLA typing), etc.
  • Full and partial DNA sequencing, including whole genome and exome studies
  • Mosaicism (differing genomic characteristics for different specimens from the same subject)
  • Mitochondrial DNA variations

At present, this implementation guide focuses solely on data structures - what data should be/might be present and how it should be organized. It does not address workflows around how reports are requested, created, approved, routed, delivered, amended, etc. The implementation guide is also paradigm-independent - the data structures presented here could be used in RESTful, messaging, documents or other mechanisms.

Guiding principles

This guide adheres to a set of design approaches:

  • It is intended to be international in scope and only leverages terminologies which are freely available to all countries.
  • It avoids pre-coordinating the type of variant, medication or other information into the Observation.code as this makes it easier to leverage industry standard terminologies for genomic information (e.g. HGVS) and avoids needing to duplicate this information into observation coding systems such as LOINC.
  • It maximizes the use of resources that are in common use by laboratory reporting systems for other clinical areas - specifically Observation and DiagnosticReport. This eases implementation and also reduces the chance of data being lost by systems that might not have been designed to specifically accommodate genomic-related information.
  • It minimizes the use of FHIR extensions, also with an objective of reducing the risk of data loss when information is passed to systems that might not explicitly support this implementation guide.
  • It uses separate observations for each independently useful assertion. This maximizes the discoverability and queriability of the data.
  • It tries to ensure that data is captured in a manner that's consistent regardless of the type of testing that was done to ensure data can be consistently queried even if captured differently (e.g. variations identified in assay tests are reported in the same manner as those identified through direct sequencing).
  • The guide allows for variability in the amount of discrete information captured. Systems are encouraged to populate what discrete elements they can and allows for the possibility of systems populating additional elements as their technical capability and/or time and other resources allow.
  • Where possible the guide aligns with HL7's v2 Genetic Variation Model Implementation Guide and v2 Cytogenomic Model Implementation Guide to maximize consistency for those FHIR systems converting from or otherwise interoperating with v2 systems (note that there are some variations driven by the the differeing approach between FHIR and HL7 v2 as well as additional requirements analysis going into the FHIR implementation guide).

Together, these principles should make adoption easier and allow systems to more easily adapt in a compatible way as genomic reporting continues to evolve.

Previous Specifications

FHIR STU3 included a set of profiles that provided guidance on how to convey genomic orders, results and observations. Those profiles are superceded by this implementation guide. Guidance for converting from these older profiles is found here.

Understanding FHIR

This implementation guide is based on the HL7 FHIR standard. It uses terminology, notations and design principles that are specific to FHIR. Before reading this implementation guide, it's important to be familiar with some of the basic principles of FHIR as well as general guidance on how to read FHIR specifications. Readers who are unfamiliar with FHIR are encouraged to read (or at least skim) the following prior to reading the rest of this implementation guide.

It's a good idea to also look at the Diagnostics Module and review the resources that are used as part of this implementation guide, especially Observation, DiagnosticReport and MolecularSequence.

Many Observation profiles and components in this guide require sending codes from If necessary for implementation (e.g., to map to a local system), equivalent codes from other code systems may *also* be sent, following the guidance on observation.

For learning about validation, please refer to The java validator is the most often updated tool ( but you might find this notepad plugin useful ( NOTE: It is important that your examples declare the profile in the meta tag, like this:

    <profile value=""/>
Some example usages of the java validator (NOTE: these online references are for the "current build" and would need to be adjusted as needed):
  • validating one of the examples in the IG, showing how to reference everything from an online location java -jar org.hl7.fhir.validator.jar -version 4.0 -ig hl7.fhir.uv.genomics-reporting
  • if you have an example in your local directory, you can do this java -jar org.hl7.fhir.validator.jar report-CYP2C19.xml -version 4.0 -ig hl7.fhir.uv.genomics-reporting

Content and organization

This implementation guide is organized into a set of sections. The first two sections are applicable to all types of genomic reporting. All implementers intending to do clinical genomic reporting should read 'Background' and 'General Genomic Reporting.'

The remaining sections provide support for more specialized types of reporting. They are optional. If your system is involved with genomic reports in a particular area, then read through that section of the implementation guide. However, there's no reason to read through sections that deal with reporting your system does not use.

The following table provides a list of the main sections in this guide and a summary of the content found in each:

Background Background on genomic concepts represented within this guide. It's essential reading for those who may not have a deep knowledge of genomics, but it's recommended for all implementers as it provides definitions for terms as they are used in this implementation guide. In some cases, agreement on term definitions is not unanimous within the genomics community, so this IG's use of a term may differ from the meaning you may be used to.
General Genomic Reporting Guidance and examples for the general structure of genomic reports, how to report overall interpretations and how to report genotypes, haplotypes and different types of variants. This content will be leveraged by all genomic reporting implementations.
Variant Reporting Guidance on expressing information about variants gleaned from various sequencing approaches including direct sequencing, shotgun sequencing, array-based testing, etc.
Pharmacogenomic Reporting Additional guidance and examples related to genomic testing done for the purpose of assessing genomic variations' implication on the use of medications - both for oncology and for general patient treatment
Somatic Reporting Additional guidance related to genomic testing done on somatic (non-germline) tissues, including assessments of tumors
Histocompatibility Reporting Additional guidance related to genomic testing done for histocompatibility and immunogenomics assessments, including HLA typing
HL7 Domain Analysis Use Cases Some use cases on FHIR design: Specimen Identification, Clinical Sequencing and so on
Appendix A: Relation to v2 reporting Links to v2 Genetic Variation Model Implementation Guide and v2 Cytogenomic Model Implementation Guide
Appendix B: Clinical Genomics Apps Introduction of the Clinical Genomics Applications(Genomics Advisor, etc) apply for this implementation guide
Appendix C: Domain Analysis Model A domain analysis model for various use cases in clinical genomics with an emphasis on clinical sequencing
Appendix D: External Coding Systems Reference for publicly available external coding systems
Appendix E: Glossary Table of concepts referenced on Observation profiles


The Genomics Reporting Implementation Guide (IG) was created by the HL7 Clinical Genomics Work Group