---
title: "Gene Section"
method: POST
path: "/public/v1/genes/section"
tags: ["public-genes"]
---

# Gene Section

`POST /public/v1/genes/section`

## Request

- Base URL: `https://api.helena.bio` (the document declares no server; this is the origin it was published from)
- URL: `https://api.helena.bio/public/v1/genes/section`
- Auth: none declared

## Request body

- SectionRequest
  - `gene_id` string, required
  - `request_id` string, required
  - `snapshot_id` string, nullable
  - `section` 'overview' | 'disease_validity' | 'structure' | 'constraint' | 'dosage' | 'mechanisms' | 'clinical_variants' | 'clinical_variant_consequences' | 'expression' | 'gwas' | 'phenotypes' | 'protein_pathways' | 'literature', required
  - `limit` integer
  - `cursor` string, nullable

## Response `200`

Successful Response

- SectionResponse
  - `gene_id` string, required
  - `section` 'overview' | 'disease_validity' | 'structure' | 'constraint' | 'dosage' | 'mechanisms' | 'clinical_variants' | 'clinical_variant_consequences' | 'expression' | 'gwas' | 'phenotypes' | 'protein_pathways' | 'literature', required
  - `status` 'available' | 'source_has_no_record' | 'unavailable' | 'not_integrated' | 'not_applicable', required
  - `coverage` 'complete' | 'partial' | 'truncated' | 'unknown', required
  - `coverage_scope` string, required
  - `freshness` Freshness, required
    - `last_source_check` string, nullable, required
    - `stale` boolean, required
    - `stale_reason` string, nullable, required
  - `source_ids` string[], required
  - `data` union, required
    - OverviewData
      - `kind` 'overview', required
      - `summary` string, nullable, required
      - `summary_source_id` string, nullable, required
    - DiseaseData
      - `kind` 'disease_validity', required
      - `count_unit` 'source_assertion'
      - `records` DiseaseAssertion[], required
        - `assertion_id` string, required
        - `source_id` string, required
        - `disease_id` string, required
        - `disease_name` string, required
        - `inheritance` string, nullable, required
        - `classification` string, required
        - `curation_date` string, nullable, required
        - `panel` string, nullable, required
        - `criteria_version` string, nullable, required
        - `report_url` string, required
        - `mechanism` string, nullable
        - `allelic_requirement` string, nullable
        - `mirrored_assertion_id` string, nullable
        - `original_disease_id` string, nullable
        - `submitter` string, nullable
        - `mechanism_support` string, nullable
        - `variant_consequence` string, nullable
        - `pmids` string[]
    - StructureData
      - `kind` 'structure', required
      - `count_unit` 'source_transcript_model'
      - `transcript_scope` 'MANE' | 'provider_catalog' | 'multi_source_native', required
      - `distinct_transcript_total` integer, nullable
      - `records` Transcript[], required
        - `transcript_id` string, required
        - `source_id` string, required
        - `assembly` 'GRCh37' | 'GRCh38', required
        - `assembly_accession` string, nullable, required
        - `annotation_release` string, required
        - `coordinate_system` '1-based-closed', required
        - `contig` string, required
        - `strand` '+' | '-', required
        - `start` integer, required
        - `end` integer, required
        - `mane_status` 'Select' | 'Plus Clinical', nullable, required
        - `refseq_transcript` string, nullable, required
        - `refseq_protein` string, nullable
        - `protein_id` string, nullable, required
        - `protein_length` integer, nullable
        - `exons` Exon[], required
          - `rank` integer, required
          - `start` integer, required
          - `end` integer, required
        - `coding_segments` CodingSegment[]
          - `rank` integer, required
          - `start` integer, required
          - `end` integer, required
          - `phase` 0 | 1 | 2, required
        - `stop_codon_segments` Exon[]
          - `rank` integer, required
          - `start` integer, required
          - `end` integer, required
    - ConstraintData
      - `kind` 'constraint', required
      - `count_unit` 'source_metric_record'
      - `records` ConstraintMetric[], required
        - `source_gene_id` string, nullable
        - `source_gene_namespace` 'ncbi_gene' | 'ensembl_gene', nullable
        - `source_canonical` boolean, nullable
        - `source_mane_select` boolean, nullable
        - `source_id` string, required
        - `gene_id` string, required
        - `transcript_id` string, nullable, required
        - `selection_rule` string, required
        - `pli` number, nullable, required
        - `oe_lof` number, nullable, required
        - `oe_lof_lower` number, nullable, required
        - `oe_lof_upper` number, nullable, required
        - `observed_lof` integer, nullable, required
        - `oe_missense` number, nullable
        - `oe_missense_lower` number, nullable
        - `oe_missense_upper` number, nullable
        - `observed_missense` integer, nullable
        - `expected_lof` number, nullable, required
        - `missense_z` number, nullable, required
        - `quality_flags` string[], required
        - `expected_synonymous` number, nullable
        - `expected_missense` number, nullable
        - `display_status` 'available' | 'caution' | 'unreliable'
        - `gene_flags` string[]
        - `constraint_flags` string[]
        - `reported_metrics` object
    - DosageData
      - `kind` 'dosage', required
      - `count_unit` 'source_dosage_assertion'
      - `records` DosageAssertion[], required
        - `source_id` string, required
        - `assertion_id` string, required
        - `axis` 'haploinsufficiency' | 'triplosensitivity', required
        - `score` '0' | '1' | '2' | '3' | '30' | '40' | 'Not yet evaluated' | '-1', required
        - `description` string, nullable, required
        - `disease_id` string, nullable, required
        - `evaluated_at` string, nullable, required
        - `pmids` string[], required
        - `report_url` string, required
    - MechanismsData
      - `kind` 'mechanisms', required
      - `count_unit` 'source_relation'
      - `records` MechanismAssertion[], required
        - `source_id` string, required
        - `assertion_id` string, required
        - `disease_id` string, required
        - `disease_name` string, required
        - `mechanism` string, required
        - `support` string, nullable, required
        - `allelic_requirement` string, nullable, required
        - `variant_consequence` string, nullable, required
        - `classification` string, required
        - `report_url` string, required
    - ClinicalVariantsData
      - `kind` 'clinical_variants', required
      - `count_unit` 'selected_variant_example'
      - `source_id` string, required
      - `unique_variation_total` integer, required
      - `membership_rule` 'explicit_hgnc_or_unique_ncbi_gene_crosswalk', required
      - `axes` ClinicalAxis[], required
        - `axis` 'germline' | 'somatic_clinical_impact' | 'oncogenicity', required
        - `represented_variations` integer, required
        - `classification_counts` DistributionBin[], required
          - `label` string, required
          - `count` integer, required
        - `review_status_counts` DistributionBin[], required
          - `label` string, required
          - `count` integer, required
      - `variant_type_counts` DistributionBin[], required
        - `label` string, required
        - `count` integer, required
      - `example_selection` 'lowest_variation_id_bounded_50', required
      - `records` ClinicalVariantExample[], required
        - `source_id` string, required
        - `variation_id` string, required
        - `name` string, required
        - `variant_type` string, required
        - `germline` string, nullable, required
        - `germline_review_status` string, nullable, required
        - `somatic_clinical_impact` string, nullable, required
        - `somatic_review_status` string, nullable, required
        - `oncogenicity` string, nullable, required
        - `oncogenicity_review_status` string, nullable, required
        - `source_url` string, required
        - `resolver_allele` ResolverAllele, required
          - `assembly` 'GRCh38', required
          - `chromosome` string, required
          - `position` integer, required
          - `reference` string, required
          - `alternate` string, required
        - `resolver_status` 'supported_exact_allele_requires_resolution' | 'unsupported_or_no_unique_grch38_allele', required
    - ClinicalConsequencesData
      - `kind` 'clinical_variant_consequences', required
      - `source_id` string, required
      - `count_unit` 'source_consequence_bin'
      - `eligible_variations` integer, required
      - `membership_rule` 'single_native_geneinfo_unique_ncbi_crosswalk', required
      - `consequence_scope` 'provider_transcript_collapsed_MC', required
      - `records` ClinicalConsequenceRecord[], required
        - `source_id` string, required
        - `so_id` string, required
        - `term` string, required
        - `represented_variations` integer, required
        - `axes` ClinicalAxis[], required
          - `axis` 'germline' | 'somatic_clinical_impact' | 'oncogenicity', required
          - `represented_variations` integer, required
          - `classification_counts` DistributionBin[], required
            - `label` string, required
            - `count` integer, required
          - `review_status_counts` DistributionBin[], required
            - `label` string, required
            - `count` integer, required
    - ExpressionData
      - `kind` 'expression', required
      - `count_unit` 'provider_expression_category'
      - `records` ExpressionRecord[], required
        - `source_id` string, required
        - `ensembl_gene_id` string, required
        - `tissue_id` string, required
        - `tissue_label` string, required
        - `median_tpm` number, nullable, required
        - `unit` 'TPM', required
        - `statistic` 'median', required
        - `sample_count` integer, nullable, required
        - `category_type` 'provider_expression_category', required
    - GwasData
      - `kind` 'gwas', required
      - `count_unit` 'source_association_record'
      - `records` GwasRecord[], required
        - `source_id` string, required
        - `association_id` string, required
        - `association_identity_kind` 'provider_id' | 'full_source_row_digest', required
        - `study_accession` string, required
        - `trait` string, required
        - `trait_ids` string[], required
        - `mapped_trait` string, required
        - `pmid` string, nullable, required
        - `reported_genes` string, required
        - `mapped_genes` string, required
        - `variant` string, required
        - `p_value` string, required
        - `p_value_context` string, nullable, required
        - `odds_ratio_or_beta` string, nullable, required
        - `confidence_interval` string, nullable, required
        - `source_url` string, required
        - `gene_assignment` 'reported_gene' | 'mapped_gene', required
        - `gene_assignments` string[], required
        - `mapped_gene_context` string[], required
    - PhenotypesData
      - `kind` 'phenotypes', required
      - `count_unit` 'source_relation_phenotype'
      - `records` PhenotypeRecord[], required
        - `source_id` string, required
        - `assertion_id` string, required
        - `disease_id` string, required
        - `disease_name` string, required
        - `phenotype_id` string, required
        - `phenotype_label` unknown
        - `allelic_requirement` string, nullable, required
        - `classification` string, required
        - `curation_date` string, nullable, required
        - `report_url` string, required
        - `pmids` string[], required
    - ProteinPathwaysData
      - `kind` 'protein_pathways', required
      - `count_unit` 'reviewed_protein_record'
      - `records` ProteinRecord[], required
        - `source_id` string, required
        - `accession` string, required
        - `entry_name` string, required
        - `reviewed` boolean, required
        - `protein_name` string, required
        - `protein_length` integer, required
        - `function_text` string, nullable, required
        - `function_evidence` string[], required
        - `pathway_text` string, nullable, required
        - `cross_references` ProteinCrossReference[], required
          - `database` string, required
          - `accession` string, required
          - `label` string, nullable, required
          - `source_url` string, nullable, required
        - `source_url` string, required
  - `limitations` string[], required
  - `request_id` string, required
  - `snapshot_id` string, required
  - `pagination` VariantAnalysisServicePresentationSchemasPublicGeneSchemasPagination, required
    - `observed_total` integer, nullable
    - `total` integer, nullable, required
    - `returned` integer, required
    - `count_unit` string, nullable, required
    - `next_cursor` string, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/helena/apis/helix-insight-variant-analysis-service.md) · [All operations](https://skmtc.dev/helena/apis/helix-insight-variant-analysis-service/llms.txt) · [OpenAPI document](https://skmtc.dev/helena/apis/helix-insight-variant-analysis-service/revisions/fe51fd20cdf1?raw)