---
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

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: Consequences
- `impact` string[], nullable: Impact levels
- `max_gnomad_af` number, nullable
- `include_unknown_af` boolean
- `min_depth` number, 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)

## 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

---

[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)