Genomics Reporting Implementation Guide
4.0.0-cibuild - CI Build

Genomics Reporting Implementation Guide, published by HL7 International / Clinical Genomics. This guide is not an authorized publication; it is the continuous build for version 4.0.0-cibuild built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/genomics-reporting/ and changes regularly. See the Directory of published versions

Plain Language Summary goes here

## Home Page

Official URL: http://hl7.org/fhir/uv/genomics-reporting/ImplementationGuide/hl7.fhir.uv.genomics-reporting | Version: 4.0.0-cibuild
IG Standards status: Trial-use | Maturity Level: 2 | Computable Name: GenomicsReporting

### Scope

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. 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.

This guide covers many aspects of genomic data 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

### How to Use this Guide

This implementation guide is organized into a set of sections. All implementers intending to do clinical genomic reporting should read the General Genomic Reporting and the Variant Reporting sections. To understand the key profiles in this IG, as well as their relationship to one another, start with the General Genomics Reporting section. Those new to FHIR should review the Understanding FHIR section below.

The remaining sections provide support for more specialized types of reporting. If your system is involved with genomic reports in a particular area, then read through that section of the implementation guide for further guidance.

Section | Description
--- | ---
Background | Introduces some of the key genomics terms and relationships that should be understood by those implementing this specification.
General Genomic Reporting | Overall guidance in using the profiles and transactions defined in this guide. 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.
Variant Reporting | Guidance on expressing information about variants gleaned from various sequencing approaches including direct sequencing, shotgun sequencing, array-based testing, etc.
Pharmacogenomic Reporting | 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 | Guidance related to genomic testing done on somatic (non-germline) tissues, including assessments of tumors.
Histocompatibility Reporting | Guidance related to genomic testing done for histocompatibility and immunogenomics assessments, including HLA typing.

### 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 makes the data discoverable and queryable as seen in the query guidance. Also review the guidance on the proper usage of contained resources.
- 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.

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 superseded 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.

- FHIR overview
- Developer's introduction
- (or Clinical introduction)
- FHIR data types
- Using codes
- References between resources
- How to read resource & profile definitions
- Base resource
- FHIR Validation

It is highly recommended that readers review Diagnostics Module and review the resources that are used as part of this implementation guide, especially Observation, DiagnosticReport, and MolecularSequence.

Importantly, implementers should pay close attention to the considerations in Associated Observations and Observation Grouping describing proper usage of the relationships `DiagnosticReport.result`, `Observation.hasMember`, and `Observation.derivedFrom`. Consumers of Genomic diagnostic reports MUST navigate through all `hasMember` relations, and navigate through `derivedFrom` relationships in order to ensure all clinically relevant information is seen.

Many Observation profiles and components in this guide require sending codes from http://loinc.org. 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.

Since this Implementation Guide is not targeting a specific country or region, other requirements may be needed for local reporting. Observation instances adhering to other profiles should be built to validate against one of this Implementation Guide's profiles wherever possible. Where incompatibilities may arise, it is most important to align with the codes and values for Observations and their components.

### Extending beyond this Guide

Implementers should use this guide to structure genomics data in an interoperable way. The Clinical Genomics Working Group understands that this guide is not complete, and implementers might identify additional concepts and data elements. Please review this guidance for ways to handle those use cases.

### Dependencies

IG | Package | FHIR | Comment
--- | --- | --- | ---
Genomics Reporting Implementation Guide | hl7.fhir.uv.genomics-reporting#4.0.0-cibuild | R4 |
HL7 Terminology (THO) | hl7.terminology.r4#6.5.0 | R4 | Automatically added as a dependency - all IGs depend on HL7 Terminology
FHIR Extensions Pack | hl7.fhir.uv.extensions.r4#5.2.0 | R4 |
FHIR Tooling Extensions IG | hl7.fhir.uv.tools.r4#0.8.0 | R4 | for example references

Package hl7.fhir.uv.extensions.r4#5.2.0 This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Mon, Feb 10, 2025 21:45+1100+11:00)

Package hl7.fhir.uv.tools.r4#0.8.0 This IG defines the extensions that the tools use internally. Some of these extensions are content that are being evaluated for elevation into the main spec, and others are tooling concerns (built Tue, Aug 5, 2025 20:09+1000+10:00)

### Global Profiles

There are no Global profiles defined

### Cross Version Analysis

This is an R4 IG. None of the features it uses are changed in R4B, so it can be used as is with R4B systems. Packages for both R4 (hl7.fhir.uv.genomics-reporting.r4) and R4B (hl7.fhir.uv.genomics-reporting.r4b) are available.

### IP Statements

This publication includes IP covered under the following statements.

- Copyrights permitted under terms specified by Creative Commons Attribution 4.0 International (CC BY 4.0) .Consistent with the terms of CC BY 4.0, HL7 is permitted to share, copy and redistribute the material in any medium or format and adapt, remix, transform, and build upon the material for its purposes as long as the CC BY 4.0 license terms are upheld. HL7 must must give appropriate credit, provide a link to the license, and indicate if changes were made. HL7 may do so in any reasonable manner, but not in any way that suggests the licensor endorses HL7 or it's use. And HL7 may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.
  Show Usage
  - Mondo Disease Ontology: Bundle/bundle-cgexample, Bundle/bundle-cgexample-withGrouping and Observation/obs-idh-ex
- Information that is created by or for the US government are within the public domain. Public domain information on the National Library of Medicine (NLM) Web pages may be freely distributed and copied. However, it is requested that in any subsequent use of this work, NLM be given appropriate acknowledgment.NOTE: This site contains resources which incorporate material contributed or licensed by individuals, companies, or organizations that may be protected by U.S. and foreign copyright laws. These include, but are not limited to PubMed Central (PMC) (see PMC Copyright Notice via https://www.ncbi.nlm.nih.gov/pmc/about/copyright/), Bookshelf (see Bookshelf Copyright Notice via https://www.ncbi.nlm.nih.gov/books/about/copyright/), OMIM (see OMIM Copyright Status via https://omim.org/help/copyright), and PubChem. All persons reproducing, redistributing, or making commercial use of this information are expected to adhere to the terms and conditions asserted by the copyright holder. Transmission or reproduction of protected items beyond that allowed by fair use (https://www.copyright.gov/fls/fl102.html)(PDF) as defined in the copyright laws requires the written permission of the copyright owners.For information on NCBI's policies and disclaimers for use, see here https://www.ncbi.nlm.nih.gov/home/about/policies/.
  Show Usage
  - ClinVar Variant ID: Bundle/bundle-cgexample, Bundle/bundle-cgexample-withGrouping... Show 10 more, Bundle/bundle-complexVariant-nonHGVS, Bundle/bundle-compound-heterozygote, Bundle/bundle-oncology-diagnostic, Observation/GenotypeExample1, Observation/HaplotypeSet-Clinical-Trial-Example-1of2, Observation/HaplotypeSet-Clinical-Trial-Example-2of2, Observation/MSH2-del-var, Observation/NTHL1-snv-var, Observation/Pgx-geno-1001 and Observation/RepeatExpansion
- It is a condition of HGNC funding from NIH and the Welcome Trust that the nomenclature and information provided is freely available to all. Anyone may use the HGNC data, but we request that they reference the "HUGO Gene Nomenclature Committee at the European Bioinformatics Institute" and the website where possible.
  Show Usage
  - HUGO Gene Nomenclature Committee Genes: Bundle/bundle-CG-IG-HLA-FullBundle-01, Bundle/bundle-cgexample... Show 60 more, Bundle/bundle-cgexample-withGrouping, Bundle/bundle-oncology-diagnostic, Bundle/bundle-oncology-report-example, Bundle/bundle-oncologyexamples-r4, Bundle/bundle-oncologyexamples-r4-withGrouping, Bundle/bundle-pgxexample, GenomicFinding, GenomicStudyAnalysisRegions, HGNCVS, MolecularBiomarker, Observation/ATR-insertion-var, Observation/EGFR-L858R-var, Observation/Genotype-Clinical-Trial-Example-using-haplotypes, Observation/GenotypeExample1, Observation/GenotypeExamplePharmVar, Observation/HER2byImmuneStainExample, Observation/HER2byImmunoassayExample, Observation/HLA-A-haplotype1, Observation/HLA-A-haplotype2, Observation/HLA-B-haplotype1, Observation/HLA-B-haplotype2, Observation/HLA-C-haplotype1, Observation/HLA-C-haplotype2, Observation/HaplotypeExamplePharmVar01, Observation/HaplotypeExamplePharmVar02, Observation/HaplotypeSet-Clinical-Trial-Example-1of2, Observation/HaplotypeSet-Clinical-Trial-Example-2of2, Observation/MSH2-del-var, Observation/MultipleRepeatExpansions, Observation/NOTCH1-uncertain-var, Observation/NTHL1-snv-var, Observation/PDL1Example, Observation/Pgx-geno-1001, Observation/Pgx-geno-1002, Observation/Pgx-geno-1003, Observation/Pgx-var-1011, Observation/Pgx-var-1012, Observation/Pgx-var-1013, Observation/Pgx-var-1014, Observation/Pgx-var-1015, Observation/Pgx-var-1016, Observation/Pgx-var-1017, Observation/Pgx-var-1018, Observation/Pgx-var-1019, Observation/Pgx-var-1020, Observation/Pgx-var-1021, Observation/ROS1-Fusion-var, Observation/RepeatExpansion, Observation/SNVexample, Observation/STAG2-insertion-var, Observation/Variant-Somatic-Clinical-Trial, Observation/ZFHX3-uncertain-var, Observation/genotype-hla-a-glstring-r4, Observation/haplotype-hla-a-1-r4, Observation/obs1-interact-smn1-smn2, Observation/obs2-interact-smn1-smn2, Parameters/FindSubjectHaplotypesOutput, Parameters/FindSubjectSpecificHaplotypesOutput, Procedure/PGXGenomicStudyAnalysis and Procedure/analysisTumorNormalDNA
  - HUGO Gene Nomenclature Committee Gene Group: GenomicFinding, GenomicStudyAnalysisRegions, HGNCVS and MolecularBiomarker
- NCBI's Disclaimer and Copyright notice must be evident to users of your service.Information that is created by or for the US government on this site is within the public domain. Public domain information on the National Library of Medicine (NLM) Web pages may be freely distributed and copied. However, it is requested that in any subsequent use of this work, NLM be given appropriate acknowledgment.NOTE: This site contains resources which incorporate material contributed or licensed by individuals, companies, or organizations that may be protected by U.S. and foreign copyright laws. These include, but are not limited to PubMed Central (PMC) (see PMC Copyright Notice at https://www.ncbi.nlm.nih.gov/pmc/about/copyright/), Bookshelf (see Bookshelf Copyright Notice at https://www.ncbi.nlm.nih.gov/books/about/copyright/), OMIM (see OMIM Copyright Status at https://omim.org/help/copyright), and PubChem. All persons reproducing, redistributing, or making commercial use of this information are expected to adhere to the terms and conditions asserted by the copyright holder. Transmission or reproduction of protected items beyond that allowed by fair use (https://www.copyright.gov/fls/fl102.html)(PDF) as defined in the copyright laws requires the written permission of the copyright owners.General copyright, as stated on NCBI's GTR site (https://www.ncbi.nlm.nih.gov/gtr/), is as included in the Copyright Statement.
  Show Usage
  - Genetic Testing Registry: Bundle/bundle-CG-IG-HLA-FullBundle-01
- See https://clinicaltrials.gov/about-site/terms-conditions for the Terms and Conditions that apply for use of ClinicalTrials.gov data.
  Show Usage
  - ClinicalTrials.gov: Observation/ROS1-Fusion-therapuTrial, Observation/Therapeutic-Implication-Clinical-Trial-2 and Observation/Therapeutic-Implication-Clinical-Trial-Somatic
- The HPO vocabularies, annotation files, tools and documentation are freely available.
- The HPO is copyrighted to protect the integrity of the vocabularies, which means that changes to the HPO vocabularies need to be done by HPO developers. However, anyone can download the HPO and use the ontologies or other HPO files under three conditions:
- That the Human Phenotype Ontology Consortium is acknowledged and cited properly.
- That any HPO Consortium file(s) displayed publicly include the date(s) and/or version number(s) of the relevant HPO file(s).
- That neither the content of the HPO file(s) nor the logical relationships embedded within the HPO file(s) be altered in any way. (Content additions and modifications have to be suggested using our issue tracker .)
- Users of the HPO should add the following statement to their online presence. This service/product uses the Human Phenotype Ontology (version information). Find out more at http://www.human-phenotype-ontology.org. We request that the HPO logo be included as well.
Show Usage

- Human Phenotype Ontology: ConditionInheritanceModeVS, DiagnosticImplication and Observation/obs-idh-ex

- The PharmVar database content is licensed under a Creative Commons Attribution-ShareAlike 4.0 International license that allows for the sharing and adaptation of our information with proper attribution.See https://www.pharmvar.org/terms-and-conditions for Terms and Conditions.
  Show Usage
  - Pharmacogene Variation: Bundle/bundle-cgexample, Bundle/bundle-cgexample-withGrouping... Show 4 more, Bundle/bundle-pgxexample, Observation/HaplotypeExamplePharmVar01, Observation/HaplotypeExamplePharmVar02 and Parameters/FindSubjectHaplotypesOutput
- The Sequence Ontology: A tool for the unification of genome annotations. Eilbeck K., Lewis S.E., Mungall C.J., Yandell M., Stein L., Durbin R., Ashburner M. Genome Biology (2005) 6:R44 Please also include the version of SO used.Sequence Ontology data and data products are licensed under the Creative Commons Attribution 4.0 Unported License .
  Show Usage
  - Sequence Ontology: Bundle/bundle-oncology-report-example, DNAChangeTypeVS... Show 50 more, FunctionalEffectVS, GenomicStudyAnalysisChangeType, GenomicStudyChangeTypeVS, MolecularConsequence, MolecularConsequenceVS, Observation/ATR-insertion-molc, Observation/ATR-insertion-var, Observation/EGFR-L858R-molc, Observation/EGFR-L858R-var, Observation/ExampleGermlineCNV, Observation/ExampleGermlineDEL, Observation/ExampleGermlineINV, Observation/ExampleSomaticCNV, Observation/ExampleSomaticDEL, Observation/ExampleSomaticINV, Observation/MSH2-del-molc, Observation/MSH2-del-var, Observation/NOTCH1-uncertain-molc, Observation/NTHL1-snv-molc, Observation/NTHL1-snv-var, Observation/Pgx-var-1011, Observation/Pgx-var-1012, Observation/Pgx-var-1013, Observation/Pgx-var-1014, Observation/Pgx-var-1015, Observation/Pgx-var-1016, Observation/Pgx-var-1017, Observation/Pgx-var-1018, Observation/Pgx-var-1019, Observation/Pgx-var-1020, Observation/Pgx-var-1021, Observation/ROS1-Fusion, Observation/STAG2-insertion-molc, Observation/STAG2-insertion-var, Observation/ZFHX3-uncertain-molc, Observation/molec-conseq1, Observation/molec-conseq2, Observation/molec-conseq3, Observation/molec-conseq4, Observation/obs1-interact-smn1-smn2, Observation/obs2-interact-smn1-smn2, Parameters/FindStudyMetadataOutput, Parameters/FindSubjectMolecConseqOutput, Parameters/FindSubjectStructuralIntersectingVariantsOutput, Parameters/FindSubjectStructuralSubsumingVariantsOutput, Procedure/analysisTumorNormalDNA, Procedure/analysisTumorRNA, Procedure/lungMass-analysis1, Procedure/lungMass-analysis2 and Variant
- The UCUM codes, UCUM table (regardless of format), and UCUM Specification are copyright 1999-2009, Regenstrief Institute, Inc. and the Unified Codes for Units of Measures (UCUM) Organization. All rights reserved. https://ucum.org/trac/wiki/TermsOfUse
  Show Usage
  - Unified Code for Units of Measure (UCUM): Bundle/bundle-cgexample, Bundle/bundle-cgexample-withGrouping... Show 20 more, Bundle/bundle-oncology-diagnostic, Bundle/bundle-oncology-report-example, Bundle/bundle-oncologyexamples-r4, Bundle/bundle-oncologyexamples-r4-withGrouping, Observation/ATR-insertion-var, Observation/EGFR-L858R-var, Observation/ExampleGermlineCNV, Observation/ExampleSomaticCNV, Observation/ExampleSomaticDEL, Observation/NOTCH1-uncertain-var, Observation/SNVexample, Observation/STAG2-insertion-var, Observation/ZFHX3-uncertain-var, Observation/obs1-interact-smn1-smn2, Observation/obs2-interact-smn1-smn2, Observation/variant-with-molec-consequences, Parameters/FindSubjectMolecConseqOutput, Parameters/FindSubjectStructuralSubsumingVariantsOutput, Parameters/FindSubjectVariantsOutput and RiskAssessment/GenRiskDiabetesT2
- The content on the Website including but not limited to the content of ISCN 2020 in whole or in parts, the title, the logo, graphic designs or adverts are the intellectual property of S. Karger AG (Basel) or published with permission from the legal copyright owner. All rights are reserved. Unless otherwise noted, no part of the content on the Website may be translated into other languages, reproduced or utilized in any form or by any means, electronic or mechanical, including photocopying, recording, microcopying, or by any information storage and retrieval system, without permission in writing from Karger.For further information or permission requests please see the explanations under Rights and Permissions (https://www.karger.com/Services/RightsPermissions).
  Show Usage
  - International System for Human Cytogenomic Nomenclature (ISCN): Observation/ISCN-CMLExample and Observation/ISCN-NormalExample
- This material contains content from LOINC. LOINC is copyright © 1995-2020, Regenstrief Institute, Inc. and the Logical Observation Identifiers Names and Codes (LOINC) Committee and is available at no cost under the license. LOINC® is a registered United States trademark of Regenstrief Institute, Inc.
  Show Usage
  - LOINC: Bundle/bundle-CG-IG-HLA-FullBundle-01, Bundle/bundle-CYP2C19... Show 157 more, Bundle/bundle-cgexample, Bundle/bundle-cgexample-withGrouping, Bundle/bundle-complexVariant-nonHGVS, Bundle/bundle-compound-heterozygote, Bundle/bundle-oncology-diagnostic, Bundle/bundle-oncology-report-example, Bundle/bundle-oncologyexamples-r4, Bundle/bundle-oncologyexamples-r4-withGrouping, Bundle/bundle-pgxexample, Bundle/bundle-sequence-phase-relation-CYP2C19, DiagnosticImplication, DiagnosticReport/GenomicReportExample01, DiagnosticReport/PGxGenomicReportEMERGE, DiagnosticReport/PGxGenomicReportEMERGE-withGrouping, DiagnosticReport/diagnosticreport-hla-glstring-r4, DiagnosticReport/somaticReport, GeneticTherapeuticImplicationsVS, GenomicAnnotation, GenomicFinding, GenomicImplication, GenomicReport, Genotype, Haplotype, MolecularBiomarker, MolecularBiomarkerCodeVS, MolecularConsequence, Observation/ATR-insertion-molc, Observation/ATR-insertion-significance, Observation/ATR-insertion-var, Observation/AnnotationExample, Observation/EGFR-L858R-molc, Observation/EGFR-L858R-significance, Observation/EGFR-L858R-therapuDrug1, Observation/EGFR-L858R-therapuDrug2, Observation/EGFR-L858R-var, Observation/ExampleGermlineCNV, Observation/ExampleGermlineDEL, Observation/ExampleGermlineINV, Observation/ExampleSomaticCNV, Observation/ExampleSomaticDEL, Observation/ExampleSomaticINV, Observation/Genotype-Clinical-Trial-Example-using-haplotypes, Observation/GenotypeExample1, Observation/GenotypeExamplePharmVar, Observation/HER2byImmuneStainExample, Observation/HER2byImmunoassayExample, Observation/HLA-A-haplotype1, Observation/HLA-A-haplotype2, Observation/HLA-B-haplotype1, Observation/HLA-B-haplotype2, Observation/HLA-C-haplotype1, Observation/HLA-C-haplotype2, Observation/HaplotypeExamplePharmVar01, Observation/HaplotypeExamplePharmVar02, Observation/HaplotypeSet-Clinical-Trial-Example-1of2, Observation/HaplotypeSet-Clinical-Trial-Example-2of2, Observation/ISCN-CMLExample, Observation/ISCN-CMLImplication, Observation/ISCN-NormalExample, Observation/MSH2-del-disease, Observation/MSH2-del-molc, Observation/MSH2-del-var, Observation/MSIExample, Observation/MicrosatelliteInstabilityExample01, Observation/MultipleRepeatExpansions, Observation/NOTCH1-significance, Observation/NOTCH1-uncertain-molc, Observation/NOTCH1-uncertain-var, Observation/NTHL1-snv-disease, Observation/NTHL1-snv-molc, Observation/NTHL1-snv-var, Observation/PDL1Example, Observation/Pgx-geno-1001, Observation/Pgx-geno-1002, Observation/Pgx-geno-1003, Observation/Pgx-var-1011, Observation/Pgx-var-1012, Observation/Pgx-var-1013, Observation/Pgx-var-1014, Observation/Pgx-var-1015, Observation/Pgx-var-1016, Observation/Pgx-var-1017, Observation/Pgx-var-1018, Observation/Pgx-var-1019, Observation/Pgx-var-1020, Observation/Pgx-var-1021, Observation/PolyGenicDiagnosticImpExample, Observation/ROS1-Fusion-disease, Observation/ROS1-Fusion-therapuDrug, Observation/ROS1-Fusion-therapuTrial, Observation/ROS1-Fusion-var, Observation/RepeatExpansion, Observation/SNVexample, Observation/STAG2-insertion-molc, Observation/STAG2-insertion-significance, Observation/STAG2-insertion-var, Observation/SequencePhaseRelationExample1, Observation/TMB-therapuDrug, Observation/TMBExample, Observation/Therapeutic-Implication-Clinical-Trial-Somatic, Observation/TherapeuticImplicationExample1, Observation/TumorMutationBurdenExample01, Observation/TxImp01, Observation/TxImp02, Observation/TxImp03, Observation/TxImp04, Observation/TxImp05, Observation/TxImp06, Observation/Variant-Somatic-Clinical-Trial, Observation/VariantExample, Observation/VariantExample1, Observation/VariantExample2, Observation/ZFHX3-significance, Observation/ZFHX3-uncertain-molc, Observation/ZFHX3-uncertain-var, Observation/diagnosticImplication-interact-smn1-smn2, Observation/genotype-hla-a-glstring-r4, Observation/haplotype-hla-a-1-r4, Observation/molec-conseq1, Observation/molec-conseq2, Observation/molec-conseq3, Observation/molec-conseq4, Observation/obs-idh-ex, Observation/obs1-interact-smn1-smn2, Observation/obs2-interact-smn1-smn2, Observation/pop-allele-freq, Observation/therapuDrug1-interact-smn1-smn2, Observation/therapuDrug2-interact-smn1-smn2, Observation/therapuDrug3-interact-smn1-smn2, Observation/variant-with-molec-consequences, Parameters/FindStudyMetadataOutput, Parameters/FindSubjectDxImplicationsOutput, Parameters/FindSubjectHaplotypesOutput, Parameters/FindSubjectMolecConseqOutput, Parameters/FindSubjectSpecificHaplotypesOutput, Parameters/FindSubjectSpecificVariantsOutput, Parameters/FindSubjectStructuralIntersectingVariantsOutput, Parameters/FindSubjectStructuralSubsumingVariantsOutput, Parameters/FindSubjectTxImplicationsOutput, Parameters/FindSubjectVariantsOutput, Procedure/PGXGenomicStudyAnalysis, Procedure/analysisTumorNormalDNA, Procedure/genomicstudyanalysis-trio2, Procedure/lungMass-analysis1, Procedure/lungMass-analysis2, SequencePhaseRelationship, ServiceRequest/ExampleServiceRequest, ServiceRequest/GenomicServiceRequestExample01, ServiceRequest/servicerequest-hla-a-r4, Task/MedicationRecommendationExample1, Task/PGxRecEx01, Task/PGxRecEx02, Task/PGxRecEx03, Task/PGxRecEx04, Task/PGxRecEx05, TherapeuticImplication and Variant
- This material contains content that is copyright of SNOMED International. Implementers of these specifications must have the appropriate SNOMED CT Affiliate license - for more information contact https://www.snomed.org/get-snomed or info@snomed.org.
  Show Usage
  - SNOMED Clinical Terms&reg; (SNOMED CT&reg;): Bundle/bundle-CG-IG-HLA-FullBundle-01, Bundle/bundle-cgexample... Show 34 more, Bundle/bundle-cgexample-withGrouping, Device/triodenovo-software, GeneticTherapeuticImplicationsVS, Observation/AnnotationExample, Observation/EGFR-L858R-therapuDrug1, Observation/EGFR-L858R-therapuDrug2, Observation/ISCN-CMLImplication, Observation/MSH2-del-disease, Observation/NTHL1-snv-disease, Observation/PolyGenicDiagnosticImpExample, Observation/ROS1-Fusion-therapuDrug, Observation/ROS1-Fusion-therapuTrial, Observation/TMB-therapuDrug, Observation/Therapeutic-Implication-Clinical-Trial-2, Observation/Therapeutic-Implication-Clinical-Trial-Somatic, Observation/Variant-Somatic-Clinical-Trial, Observation/diagnosticImplication-interact-smn1-smn2, Observation/therapuDrug1-interact-smn1-smn2, Observation/therapuDrug2-interact-smn1-smn2, Observation/therapuDrug3-interact-smn1-smn2, Parameters/FindSubjectDxImplicationsOutput, Procedure/SequencingProcedure, Procedure/lungMass, Procedure/somaticStudy, RiskAssessment/GenRiskDiabetesT2, ServiceRequest/genomicServiceRequest, ServiceRequest/servicerequest-hla-a-r4, ServiceRequest/somaticServiceRequest, Specimen/GenomicSpecimenExample02, Specimen/genomicSpecimen, Specimen/normalSpecimen, Specimen/specimen-hla-r4, Specimen/tumorSpecimen and TherapeuticImplication
- This material derives from the HL7 Terminology (THO). THO is copyright ©1989+ Health Level Seven International and is made available under the CC0 designation. For more licensing information see: https://terminology.hl7.org/license.html
  Show Usage
  - Observation Category Codes: Bundle/bundle-CG-IG-HLA-FullBundle-01, Bundle/bundle-CYP2C19... Show 152 more, Bundle/bundle-cgexample, Bundle/bundle-cgexample-withGrouping, Bundle/bundle-complexVariant-nonHGVS, Bundle/bundle-compound-heterozygote, Bundle/bundle-oncology-diagnostic, Bundle/bundle-oncology-report-example, Bundle/bundle-oncologyexamples-r4, Bundle/bundle-oncologyexamples-r4-withGrouping, Bundle/bundle-pgxexample, Bundle/bundle-sequence-phase-relation-CYP2C19, DiagnosticImplication, GenomicAnnotation, GenomicBase, GenomicFinding, GenomicImplication, GenomicStudy, GenomicStudyAnalysis, Genotype, Haplotype, MolecularBiomarker, MolecularConsequence, Observation/ATR-insertion-molc, Observation/ATR-insertion-significance, Observation/ATR-insertion-var, Observation/AnnotationExample, Observation/EGFR-L858R-molc, Observation/EGFR-L858R-significance, Observation/EGFR-L858R-therapuDrug1, Observation/EGFR-L858R-therapuDrug2, Observation/EGFR-L858R-var, Observation/ExampleGermlineCNV, Observation/ExampleGermlineDEL, Observation/ExampleGermlineINV, Observation/ExampleSomaticCNV, Observation/ExampleSomaticDEL, Observation/ExampleSomaticINV, Observation/Genotype-Clinical-Trial-Example-using-haplotypes, Observation/GenotypeExample1, Observation/GenotypeExamplePharmVar, Observation/GrouperEx01, Observation/GrouperEx02, Observation/GrouperEx03, Observation/HER2byImmuneStainExample, Observation/HER2byImmunoassayExample, Observation/HLA-A-haplotype1, Observation/HLA-A-haplotype2, Observation/HLA-B-haplotype1, Observation/HLA-B-haplotype2, Observation/HLA-C-haplotype1, Observation/HLA-C-haplotype2, Observation/HaplotypeExamplePharmVar01, Observation/HaplotypeExamplePharmVar02, Observation/HaplotypeSet-Clinical-Trial-Example-1of2, Observation/HaplotypeSet-Clinical-Trial-Example-2of2, Observation/ISCN-CMLExample, Observation/ISCN-CMLImplication, Observation/ISCN-NormalExample, Observation/MSH2-del-disease, Observation/MSH2-del-molc, Observation/MSH2-del-var, Observation/MSIExample, Observation/MicrosatelliteInstabilityExample01, Observation/MultipleRepeatExpansions, Observation/NOTCH1-significance, Observation/NOTCH1-uncertain-molc, Observation/NOTCH1-uncertain-var, Observation/NTHL1-snv-disease, Observation/NTHL1-snv-molc, Observation/NTHL1-snv-var, Observation/PDL1Example, Observation/Pgx-geno-1001, Observation/Pgx-geno-1002, Observation/Pgx-geno-1003, Observation/Pgx-var-1011, Observation/Pgx-var-1012, Observation/Pgx-var-1013, Observation/Pgx-var-1014, Observation/Pgx-var-1015, Observation/Pgx-var-1016, Observation/Pgx-var-1017, Observation/Pgx-var-1018, Observation/Pgx-var-1019, Observation/Pgx-var-1020, Observation/Pgx-var-1021, Observation/PolyGenicDiagnosticImpExample, Observation/ROS1-Fusion, Observation/ROS1-Fusion-disease, Observation/ROS1-Fusion-therapuDrug, Observation/ROS1-Fusion-therapuTrial, Observation/ROS1-Fusion-var, Observation/RepeatExpansion, Observation/SNVexample, Observation/STAG2-insertion-molc, Observation/STAG2-insertion-significance, Observation/STAG2-insertion-var, Observation/SequencePhaseRelationExample1, Observation/TMB-therapuDrug, Observation/TMBExample, Observation/Therapeutic-Implication-Clinical-Trial-2, Observation/Therapeutic-Implication-Clinical-Trial-Somatic, Observation/TherapeuticImplicationExample1, Observation/TumorMutationBurdenExample01, Observation/TxImp01, Observation/TxImp02, Observation/TxImp03, Observation/TxImp04, Observation/TxImp05, Observation/TxImp06, Observation/Variant-Somatic-Clinical-Trial, Observation/VariantExample, Observation/VariantExample1, Observation/VariantExample2, Observation/ZFHX3-significance, Observation/ZFHX3-uncertain-molc, Observation/ZFHX3-uncertain-var, Observation/diagnosticImplication-interact-smn1-smn2, Observation/genotype-hla-a-glstring-r4, Observation/haplotype-hla-a-1-r4, Observation/molec-conseq1, Observation/molec-conseq2, Observation/molec-conseq3, Observation/molec-conseq4, Observation/obs-idh-ex, Observation/obs1-interact-smn1-smn2, Observation/obs2-interact-smn1-smn2, Observation/pop-allele-freq, Observation/therapuDrug1-interact-smn1-smn2, Observation/therapuDrug2-interact-smn1-smn2, Observation/therapuDrug3-interact-smn1-smn2, Observation/variant-with-molec-consequences, Parameters/FindSubjectDxImplicationsOutput, Parameters/FindSubjectHaplotypesOutput, Parameters/FindSubjectMolecConseqOutput, Parameters/FindSubjectSpecificHaplotypesOutput, Parameters/FindSubjectSpecificVariantsOutput, Parameters/FindSubjectStructuralIntersectingVariantsOutput, Parameters/FindSubjectStructuralSubsumingVariantsOutput, Parameters/FindSubjectTxImplicationsOutput, Parameters/FindSubjectVariantsOutput, Procedure/PGXGenomicStudy, Procedure/PGXGenomicStudyAnalysis, Procedure/analysisTumorNormalDNA, Procedure/analysisTumorRNA, Procedure/genomicstudy-trio2, Procedure/genomicstudyanalysis-trio2, Procedure/lungMass, Procedure/lungMass-analysis1, Procedure/lungMass-analysis2, Procedure/somaticStudy, SequencePhaseRelationship, TherapeuticImplication and Variant
  - Risk Probability: RiskAssessment/GenRiskDiabetesT2
  - diagnosticServiceSectionId: Bundle/bundle-CG-IG-HLA-FullBundle-01, Bundle/bundle-CYP2C19... Show 144 more, Bundle/bundle-cgexample, Bundle/bundle-cgexample-withGrouping, Bundle/bundle-complexVariant-nonHGVS, Bundle/bundle-compound-heterozygote, Bundle/bundle-oncology-diagnostic, Bundle/bundle-oncology-report-example, Bundle/bundle-oncologyexamples-r4, Bundle/bundle-oncologyexamples-r4-withGrouping, Bundle/bundle-pgxexample, Bundle/bundle-sequence-phase-relation-CYP2C19, DiagnosticImplication, DiagnosticReport/GenomicReportExample01, DiagnosticReport/PGxGenomicReportEMERGE, DiagnosticReport/PGxGenomicReportEMERGE-withGrouping, DiagnosticReport/diagnosticreport-hla-glstring-r4, DiagnosticReport/somaticReport, GenomicAnnotation, GenomicBase, GenomicFinding, GenomicImplication, GenomicReport, Genotype, Haplotype, MolecularBiomarker, MolecularConsequence, Observation/ATR-insertion-molc, Observation/ATR-insertion-significance, Observation/ATR-insertion-var, Observation/AnnotationExample, Observation/EGFR-L858R-molc, Observation/EGFR-L858R-significance, Observation/EGFR-L858R-therapuDrug1, Observation/EGFR-L858R-therapuDrug2, Observation/EGFR-L858R-var, Observation/ExampleGermlineCNV, Observation/ExampleGermlineDEL, Observation/ExampleGermlineINV, Observation/ExampleSomaticCNV, Observation/ExampleSomaticDEL, Observation/ExampleSomaticINV, Observation/Genotype-Clinical-Trial-Example-using-haplotypes, Observation/GenotypeExample1, Observation/GenotypeExamplePharmVar, Observation/GrouperEx01, Observation/GrouperEx02, Observation/GrouperEx03, Observation/HLA-A-haplotype1, Observation/HLA-A-haplotype2, Observation/HLA-B-haplotype1, Observation/HLA-B-haplotype2, Observation/HLA-C-haplotype1, Observation/HLA-C-haplotype2, Observation/HaplotypeExamplePharmVar01, Observation/HaplotypeExamplePharmVar02, Observation/HaplotypeSet-Clinical-Trial-Example-1of2, Observation/HaplotypeSet-Clinical-Trial-Example-2of2, Observation/ISCN-CMLExample, Observation/ISCN-CMLImplication, Observation/ISCN-NormalExample, Observation/MSH2-del-disease, Observation/MSH2-del-molc, Observation/MSH2-del-var, Observation/MSIExample, Observation/MicrosatelliteInstabilityExample01, Observation/MultipleRepeatExpansions, Observation/NOTCH1-significance, Observation/NOTCH1-uncertain-molc, Observation/NOTCH1-uncertain-var, Observation/NTHL1-snv-disease, Observation/NTHL1-snv-molc, Observation/NTHL1-snv-var, Observation/PDL1Example, Observation/Pgx-geno-1001, Observation/Pgx-geno-1002, Observation/Pgx-geno-1003, Observation/Pgx-var-1011, Observation/Pgx-var-1012, Observation/Pgx-var-1013, Observation/Pgx-var-1014, Observation/Pgx-var-1015, Observation/Pgx-var-1016, Observation/Pgx-var-1017, Observation/Pgx-var-1018, Observation/Pgx-var-1019, Observation/Pgx-var-1020, Observation/Pgx-var-1021, Observation/PolyGenicDiagnosticImpExample, Observation/ROS1-Fusion, Observation/ROS1-Fusion-disease, Observation/ROS1-Fusion-therapuDrug, Observation/ROS1-Fusion-therapuTrial, Observation/ROS1-Fusion-var, Observation/RepeatExpansion, Observation/SNVexample, Observation/STAG2-insertion-molc, Observation/STAG2-insertion-significance, Observation/STAG2-insertion-var, Observation/SequencePhaseRelationExample1, Observation/TMB-therapuDrug, Observation/TMBExample, Observation/Therapeutic-Implication-Clinical-Trial-2, Observation/Therapeutic-Implication-Clinical-Trial-Somatic, Observation/TherapeuticImplicationExample1, Observation/TumorMutationBurdenExample01, Observation/TxImp01, Observation/TxImp02, Observation/TxImp03, Observation/TxImp04, Observation/TxImp05, Observation/TxImp06, Observation/Variant-Somatic-Clinical-Trial, Observation/VariantExample, Observation/VariantExample1, Observation/VariantExample2, Observation/ZFHX3-significance, Observation/ZFHX3-uncertain-molc, Observation/ZFHX3-uncertain-var, Observation/diagnosticImplication-interact-smn1-smn2, Observation/genotype-hla-a-glstring-r4, Observation/haplotype-hla-a-1-r4, Observation/molec-conseq1, Observation/molec-conseq2, Observation/molec-conseq3, Observation/molec-conseq4, Observation/obs-idh-ex, Observation/obs1-interact-smn1-smn2, Observation/obs2-interact-smn1-smn2, Observation/pop-allele-freq, Observation/therapuDrug1-interact-smn1-smn2, Observation/therapuDrug2-interact-smn1-smn2, Observation/therapuDrug3-interact-smn1-smn2, Observation/variant-with-molec-consequences, Parameters/FindSubjectDxImplicationsOutput, Parameters/FindSubjectHaplotypesOutput, Parameters/FindSubjectMolecConseqOutput, Parameters/FindSubjectSpecificHaplotypesOutput, Parameters/FindSubjectSpecificVariantsOutput, Parameters/FindSubjectStructuralIntersectingVariantsOutput, Parameters/FindSubjectStructuralSubsumingVariantsOutput, Parameters/FindSubjectTxImplicationsOutput, Parameters/FindSubjectVariantsOutput, SequencePhaseRelationship, TherapeuticImplication and Variant
  - identifierType: Bundle/bundle-CG-IG-HLA-FullBundle-01, DiagnosticReport/somaticReport... Show 10 more, Patient/CGPatientExample01, Patient/HG00403, Patient/denovoChild, Patient/denovoFather, Patient/denovoMother, Patient/genomicPatient, Patient/somaticPatient, Practitioner/practitioner02, ServiceRequest/genomicServiceRequest and ServiceRequest/somaticServiceRequest
  - specimenType: Bundle/bundle-oncology-report-example and Specimen/GenomicSpecimenExample01
  - Confidentiality: DocumentReference/CNVAnalysis-called, DocumentReference/FullGenome-GRCh38... Show 11 more, DocumentReference/SimpleVariantAnalysis-called, DocumentReference/UncallableRegions, DocumentReference/WES-FullSequencedRegion-GRCh38, DocumentReference/WES-UncallableRegions-GRCh38, DocumentReference/genomicFileFatherBAM, DocumentReference/genomicFileMotherBAM, DocumentReference/genomicFileProbandBAM, DocumentReference/genomicFileProbandVCF, DocumentReference/genomicVCFfile-cnv, DocumentReference/genomicVCFfile-simple and DocumentReference/somaticVCFfile
  - ParticipationType: Procedure/lungMass-analysis1 and Procedure/lungMass-analysis2
- Using RxNorm codes of type SAB=RXNORM as this specification describes does not require a UMLS license. Access to the full set of RxNorm definitions, and/or additional use of other RxNorm structures and information requires a UMLS license. The use of RxNorm in this specification is pursuant to HL7's status as a licensee of the NLM UMLS. HL7's license does not convey the right to use RxNorm to any users of this specification; implementers must acquire a license to use RxNorm in their own right.
  Show Usage
  - RxNorm: Bundle/bundle-cgexample, Bundle/bundle-cgexample-withGrouping... Show 11 more, Bundle/bundle-oncologyexamples-r4-withGrouping, Bundle/bundle-pgxexample, MedicationStatement/MedicationStatementWarfarin, Observation/TherapeuticImplicationExample1, Observation/TxImp01, Observation/TxImp02, Observation/TxImp03, Observation/TxImp04, Observation/TxImp05, Observation/TxImp06 and Parameters/FindSubjectTxImplicationsOutput

### Appendices

Appendix | Description
--- | ---
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) that apply to this implementation guide
Appendix C: Domain Analysis Model | A domain analysis model for various use cases in clinical genomics
Appendix D: Query Guidance | Query guidance based on use-cases from the Domain Analysis Document
Appendix E: External Coding Systems | Reference for publicly available external coding systems
Appendix F: Conversion from FHIR Core STU3 | Notes on since deprecated extensions defined in FHIR Core STU3
Appendix G: Molecular Sequence | Notes on the FHIR Resource for representing a Molecular Sequence
Appendix H: Grouping observations | Guidance on the types of grouping that might be encountered
Appendix I: Glossary | Table of concepts referenced on Observation profiles

### Acknowledgments

The Genomics Reporting Implementation Guide is a product of the HL7 Clinical Genomics Work Group. The work group welcomes and actively encourages feedback on this guide. Whether you have questions regarding its usage, recommendations for improvement, or identify any issues requiring correction, please don't hesitate to reach out to us! You may propose a change (see link at the bottom of the page), reach out on Zulip to chat, or email the Work Group at clingenomics@lists.hl7.org.

The authors of this guide wish to recognize the following participants who contributed their time and expertise to the continued development of this guide:

Name | Organization | Role
--- | --- | ---
Srikar Chamala | Childrens Hospital of Los Angeles | CG Co-Chair
Willie Chang | Epic | Contributor
Bob Dolin | Elimu Informatics | Contributor
Bob Freimuth | Mayo Clinic | CG Co-Chair, IM Sub-Group Lead
Bret Heale | Intermountain | Contributor
Arthur Hermann | Kaiser Permanente | Contributor
Jamie Jones | Boston Children's Hospital | CG Co-Chair, Modeling Sub-Group Lead
Aly Khalifa | Mayo Clinic | Contributor
Anand Kulanthaivel | Clinical Architecture | Contributor
Lloyd McKenzie | Dogwood Consulting | Contributor
Mullai Murugan | Baylor College of Medicine | Contributor
JD Nolen | Children's Mercy Hospital | Contributor
Kevin Power | Children's Mercy Hospital | Contributor
Joel Schneider | NMDP/CIBMTR | Contributor
May Terry | MITRE Corporation | CG Co-Chair
Michael Watkins | University of Chicago | CG Co-Chair
Patrick Werner | MOLIT Institut | CG Co-Chair