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 and changes regularly. See the Directory of published versions

OperationDefinition: Find Population Structural Intersecting Variants

Official URL: Version: 3.0.1-SNAPSHOT
Active as of 2024-07-15 Computable Name: FindPopulationStructuralIntersectingVariants

Retrieve count or list of patients having structural intersecting variants in specified regions.


Retrieve count or list of patients having structural intersecting variants in specified regions. (See section 'Genes vs. Regions' for the distinction between variants that 'intersect' vs. 'subsume' a region).

A patient meets numerator criteria if they have at least one structural variant intersecting a given range.

Population queries are designed to return a count of patients that match each item sought, with or without a list of patients matching the item(s) sought.

Generated Narrative: OperationDefinition find-population-structural-intersecting-variants



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


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


Include list of matching patients if set to true. Default=false.


range from rangeList


Count of patients having this variant


Count of patients in the cohort searched


Patient ID. Include if includePatientList=true


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


A researcher has developed a new drug, designed for cancer patients with large deletions involving all or part of BRCA1 (NC_000017.11:43044294-43125364) or BRCA2 (NC_000013.11:32315507-32400268), and wants a list of potential clinical trial participants.