This page is part of the Genetic Reporting Implementation Guide (v3.0.0-ballot: STU 3 Ballot 1) based on FHIR (HL7® FHIR® Standard) R4. The current version which supersedes this version is 2.0.0. For a full list of available versions, see the Directory of published versions
Official URL: http://hl7.org/fhir/uv/genomics-reporting/OperationDefinition/find-subject-specific-haplotypes | Version: 3.0.0-ballot | |||
Active as of 2023-12-18 | Computable Name: FindSubjectSpecificHaplotypes |
See if specified haplotypes/genotypes are present.
Parameters
Use | Name | Scope | Cardinality | Type | Binding | Documentation |
IN | subject | 1..1 | string (reference) | The subject of interest. | ||
IN | haplotypes | 1..* | string (token) | List of haplotypes and/or genotypes being sought. Must be in token or codesystem|code format. | ||
IN | testIdentifiers | 0..* | string (token) | Supply a list of test identifiers. Only results originating from one of these tests will be returned. | ||
IN | testDateRange | 0..1 | Period | Supply a date range. Only results generated during this range will be returned. | ||
IN | specimenIdentifiers | 0..* | string (token) | Supply a list of specimen identifiers. Only results derived from one of these specimens will be returned. | ||
IN | genomicSourceClass | 0..1 | string (token) | Enables an App to limit results to those that are 'germline' or 'somatic'. Default is to include haplotypes irrespective of genomic source class. | ||
OUT | haplotypes | 1..* | (one for each haplotype in haplotypeList) | |||
OUT | haplotypes.haplotypeItem | 1..1 | string | haplotype/genotype from haplotypeList | ||
OUT | haplotypes.presence | 1..1 | boolean | |||
OUT | haplotypes.haplotype | 0..* | Observation | Haplotypes must conform to [Profile: http://hl7.org/fhir/uv/genomics-reporting/StructureDefinition/haplotype]. | ||
OUT | haplotypes.genotype | 0..* | Observation | Genotypes must conform to [Profile: http://hl7.org/fhir/uv/genomics-reporting/StructureDefinition/genotype]. |
Contents:
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 |
Are any of these haplotypes present [CYP2D6 *1/*5; CYP2D6 *1/*15; CYP2C19 *1/*2]?
$find-subject-specific-haplotypes?subject=HG00403&haplotypes=CYP2D6 *1/*5,CYP2D6 *1/*15,CYP2C19 *1/*2
Is haplotype [HLA-A*02:302+HLA-A*23:26/HLA-A*23:39^HLA-B*44:02:13+HLA-B*49:08] present?
$find-subject-specific-haplotypes?subject=HG00403&haplotypes=http://glstring.org|hla#3.33.0#HLA-A*02:302+HLA-A*23:26/HLA-A*23:39^HLA-B*44:02:13+HLA-B*49:08
Patient HG00403 underwent HLA typing, and clinician wants to know if there is any haplotype or genotype indication that HLA-A*23 is present.