Build a FHIR Genomics Reporting IG diagnostic report with MolecularSequence for clinical genomics

domain: hl7.org · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

In-depth guide

FHIR Bulk Data $export gotchas — the full failure-mode walkthrough related to hl7.org, checked against official docs, with linked verified routes.

Steps

  1. Create a GenomicsReport DiagnosticReport (profile: genomics-report from hl7.fhir.uv.genomics-reporting); set DiagnosticReport.code to LOINC 81247-9 ('Master HL7 genetic variant reporting panel') or another appropriate panel code
  2. Populate DiagnosticReport.performer with the genetic testing laboratory and DiagnosticReport.specimen with the Specimen resource describing the sample (blood, tumor biopsy, saliva)
  3. Create MolecularSequence resources to capture raw sequencing context: set MolecularSequence.type to 'dna', 'rna', or 'aa'; populate the referenceSeq element with the reference genome build (e.g., GRCh38) and chromosome information
  4. Create Variant Observation resources (profile: variant from the Genomics Reporting IG) for each identified variant; link them to MolecularSequence via Observation.derivedFrom if the variant was detected from that sequence
  5. Add DiagnosticImplication Observation resources (profile: diagnostic-implication) to record clinical significance, predicted impact, and associated condition using the appropriate value sets from the Genomics Reporting IG
  6. Assemble all Variant, DiagnosticImplication, and MolecularSequence references into DiagnosticReport.result; set DiagnosticReport.status to 'final' upon completion

Known gotchas

Related routes

Record an mCODE GenomicVariant observation derived from a genomic sequencing test in FHIR
hl7.org · 6 steps · unrated
Construct and validate a FHIR IPS Composition resource with required sections for an International Patient Summary document
hl7.org · 6 steps · unrated
Understand electronic case reporting (eCR) eICR Composition profile concepts for FHIR-based case reporting
healthcare-fhir · 6 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans