---
title: "Query variants"
method: GET
path: "/sessions/{session_id}/variants"
tags: ["variants"]
---

# Query variants

`GET /sessions/{session_id}/variants`

## 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/sessions/{session_id}/variants`
- Auth: none declared
- TypeScript: <https://skmtc.dev/helena-bioinformatics/apis/helix-insight-variant-analysis-service/docs/sessions/:session_id/variants/get.ts> (a function with typed inputs; its response is checked against the schema)

Query processed variants with filters and pagination

## Path parameters

- `session_id` string, uuid, required

## Query parameters

- `acmg_class` string[], nullable: ACMG classifications
- `min_confidence` number, nullable
- `min_priority_score` number, nullable
- `gene_symbol` string[], nullable: Gene symbols (supports partial match)
- `consequence` string[], nullable
- `impact` string[], nullable: Impact levels
- `max_gnomad_af` number, nullable
- `include_unknown_af` boolean
- `min_depth` integer, nullable
- `min_quality` number, nullable
- `min_vaf` number, nullable
- `max_vaf` number, nullable
- `sv_only` boolean: Return only rows whose canonical sv_type is non-null
- `sv_group` string, nullable
- `sv_query` string, nullable
- `page` integer: Page number
- `page_size` integer: Results per page
- `sort_by` string: Sort column
- `sort_order` string: Sort order (ASC/DESC)
- `chromosome` string[], nullable
- `variant_type` string[], nullable
- `genotype` string[], nullable
- `inheritance_mode` string[], nullable
- `biotype` string[], nullable
- `acmg_criterion` string[], nullable
- `clinvar_significance` string[], nullable
- `start_position` integer, nullable
- `end_position` integer, nullable
- `has_hpo` boolean, nullable
- `min_review_stars` integer, nullable
- `quality_status` string[], nullable
- `source_filter` string[], nullable
- `min_genotype_quality` number, nullable
- `min_sift_score` number, nullable
- `max_sift_score` number, nullable
- `min_alphamissense_score` number, nullable
- `max_alphamissense_score` number, nullable
- `min_metasvm_score` number, nullable
- `max_metasvm_score` number, nullable
- `min_dann_score` number, nullable
- `max_dann_score` number, nullable
- `min_phylop100way_vertebrate` number, nullable
- `max_phylop100way_vertebrate` number, nullable
- `min_gerp_rs` number, nullable
- `max_gerp_rs` number, nullable
- `min_bayesdel_addaf_score` number, nullable
- `max_bayesdel_addaf_score` number, nullable
- `min_bayesdel_noaf_score` number, nullable
- `max_bayesdel_noaf_score` number, nullable
- `min_mpc_score` number, nullable
- `max_mpc_score` number, nullable
- `min_spliceai_max_score` number, nullable
- `max_spliceai_max_score` number, nullable
- `min_pli` number, nullable
- `max_pli` number, nullable
- `min_oe_lof_upper` number, nullable
- `max_oe_lof_upper` number, nullable
- `min_oe_lof` number, nullable
- `max_oe_lof` number, nullable
- `min_mis_z` number, nullable
- `max_mis_z` number, nullable

## Response `200`

Successful Response

- VariantQueryResponse
  - `sv_counts` object, nullable
  - `variants` object[], required: List of variants
  - `total_count` integer, required: Total number of variants matching filters
  - `page` integer, required: Current page number
  - `page_size` integer, required: Number of variants per page
  - `total_pages` integer, required: Total number of pages
  - `has_next_page` boolean, required: Whether there is a next page
  - `has_previous_page` boolean, required: Whether there is a previous page

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-06** `cf28590ba149`: 2 breaking, 42 info
  - `query` request parameter `min_depth` list-of-types was narrowed by removing types `number`
  - for the `query` request parameter `min_depth`, the type of property `anyOf[subschema #1]/` was specialized from `number` to `integer`
  - added the new optional `query` request parameter `acmg_criterion`
  - added the new optional `query` request parameter `biotype`
  - …40 more

[Operation history](https://skmtc.dev/helena-bioinformatics/apis/helix-insight-variant-analysis-service/changes/sessions/:session_id/variants/get.md)

---

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