Genomics Reporting Implementation Guide
3.0.1-SNAPSHOT - Ballot International flag

Genomics Reporting Implementation Guide, published by HL7 International / Clinical Genomics. This guide is not an authorized publication; it is the continuous build for version 3.0.1-SNAPSHOT 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

OperationDefinition: Find Subject Treatment Implications

Official URL: http://hl7.org/fhir/uv/genomics-reporting/OperationDefinition/find-subject-tx-implications Version: 3.0.1-SNAPSHOT
Active as of 2024-04-09 Computable Name: FindSubjectTxImplications

Retrieves genetic therapeutic implications for variants/haplotypes/genotypes.

Description

Retrieves genetic therapeutic implications for variants/haplotypes/genotypes.

Therapeutic implications cover a wide range of scenarios - from pharmacogenomics (e.g. a patient's genotype may be associated with altered metabolism of a specific drug) to cancer care (e.g. a patient's somatic variant may be associated with response to a specific drug and/or with eligibility for a specific clinical trial).

For pharmacogenomics, generally the operation will be called with 'subject' and 'haplotypes' parameters, which will return implications reflecting those drugs whose efficacy or safety are altered based on the patient haplotypes. Including the 'treatments' parameter will limit the return to implications for the supplied drugs. For cancer care, generally the operation will be called with 'subject' and 'ranges' parameters, which will return therapeutic implications for patient variants in supplied ranges. Including the 'conditions' parameter will limit the return to implications specific to the supplied conditions. Including the 'treatments' parameter will limit the return to implications for the supplied drugs. These parameter combinations enable, for instance, queries that check to see if a patient has any therapeutic options for somatic variants, specifically for their tumor type. For other combinations of input parameters, the operation returns therapeutic implications satisfying all parameters.

Where no variants, ranges, haplotypes, treatments, or conditions are provided, the operation returns no implications.

As shown in the following picture, this operation can return previously instantiated implications and/or dynamically computed implications. Specific implementations can indicate their capabilities using a FHIR Capability Statement. Rules around the retention of dynamically computed implications are outside the scope of this operation, but a server could potentially instantiate those results based on the Therapeutic Implication, Diagnostic Implication, or Molecular Consequence FHIR profiles.

Instantiated vs Dynamically Computed Implications

Dynamic computation of implications can return a large number of results (e.g. 'find therapeutic implications for cancer'). Results can be curtailed using additional operation parameters (e.g. 'find therapeutic implications for somatic variant NM_007294.4:c.5578del in breast cancer").

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INsubject1..1string
(reference)

The subject of interest.

INvariants0..*string
(string)

List of variants from which implications are derived. Must be in HGVS or SPDI format.

INranges0..*string
(special)

List of regions to be searched for variants. Must be in zero-based RefSeq:Integer-range format (e.g. 'NC_000007.14:55174721-55174820').

INhaplotypes0..*string
(token)

List of haplotypes and/or genotypes from which implications are derived. Must be in token or codesystem|code format.

INtreatments0..*string
(token)

List of medications and/or other therapeutic interventions for which implications are sought. Must be in token or codesystem|code format.

INconditions0..*string
(token)

List of conditions for which implications are sought. Must be in token or codesystem|code format.

INtestIdentifiers0..*string
(token)

Supply a list of test identifiers. Only results originating from one of these tests will be returned.

INtestDateRange0..1Period

Supply a date range. Only results generated during this range will be returned.

INspecimenIdentifiers0..*string
(token)

Supply a list of specimen identifiers. Only results derived from one of these specimens will be returned.

INgenomicSourceClass0..1string
(token)

Enables an App to limit results to those that are 'germline' or 'somatic'. Default is to include variants irrespective of genomic source class.

OUTimplication0..*Observation

Implications must conform to [Profile: http://hl7.org/fhir/uv/genomics-reporting/StructureDefinition/therapeutic-implication]. The target(s) of the implication's derivedFrom shall also be included in the response.

OUTvariant0..*Observation

Variants must conform to [Profile: http://hl7.org/fhir/uv/genomics-reporting/StructureDefinition/variant].

OUThaplotype0..*Observation

Haplotypes must conform to [Profile: http://hl7.org/fhir/uv/genomics-reporting/StructureDefinition/haplotype].

OUTgenotype0..*Observation

Genotypes must conform to [Profile: http://hl7.org/fhir/uv/genomics-reporting/StructureDefinition/genotype].

Notes:

Error Codes

Valid response codes are shown in the following table. Additional response codes (e.g. 5xx server error) may also be encountered.

Response Code Description
200 Successfully executed request
400 ERROR: Invalid query parameters
404 ERROR: Patient not found
422 ERROR: Failed LiftOver

Examples

Clinician seeks to determine if their patient has any potential drug-gene interactions based on the presence of their patient's CYP2C19 *1/*2 genotype.

$find-subject-tx-implications?subject=HG00403&haplotypes=CYP2C19 *1/*2

Clinician is considering the use of clopidogrel, and seeks to determine if their patient has any potential drug-gene interactions that might affect clopidogrel efficacy.

$find-subject-tx-implications?subject=HG00403&treatments=http://www.nlm.nih.gov/research/umls/rxnorm|32968

Clinician is considering treatment options for a 66 year old non-smoker recently diagnosed with metastatic non-small cell lung cancer. The clinician wants to see if patient has any NSCLC-specific druggable targets in ALK (NC_000002.12:29190991-29921589), BRAF (NC_000007.14:140713327-140924929), or EGFR (NC_000007.14:55019016-55211628).

$find-subject-tx-implications?subject=HG00403&ranges=NC_000002.12:29190991-29921589,NC_000007.14:140713327-140924929,NC_000007.14:55019016-55211628&conditions=http://sequenceontology.org|3908

This query seeks to determine if the subject has any breast cancer-specific therapeutic implications (e.g. medications, clinical trials) based on identified somatic variants in recent specimen.

$find-subject-tx-implications?subject=HG00403&conditions=http://snomed.info/sct|372137005&genomicSourceClass=somatic&specimenIdentfiers=1

This query seeks to determine if the subject has any genetic findings that have implications for inclusion in clinical trial NCT01234567.

$find-subject-tx-implications?subject=HG00403&treatments=https://clinicaltrials.gov/|NCT01234567

Patient HG00403 has metastatic breast cancer. Targeted sequencing of a tumor biopsy specimen shows ERBB2 (HER2) variant NM_004448.4:c.2264_2278del. What are the treatment implications for this patient? (Results indicate responsiveness to lapatinib).