---
title: "Descriptive QC of stored variant records"
method: GET
path: "/sessions/{session_id}/qc/variant-metrics"
tags: ["qc"]
---

# Descriptive QC of stored variant records

`GET /sessions/{session_id}/qc/variant-metrics`

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

## Path parameters

- `session_id` string, uuid, required

## Response `200`

Successful Response

- VariantQCResponse
  - `session_id` string, required
  - `available` boolean, required
  - `reason` string, nullable, required
  - `scope` 'stored_variant_records', required
  - `schema_version` 1, required
  - `single_sample` boolean, required
  - `thresholds_applied` false, required
  - `sample_metrics_reason` string, nullable, required
  - `metrics` VariantQCMetrics, required
    - `total_records` integer, required
    - `snv_count` integer, nullable, required
    - `transitions` integer, nullable, required
    - `transversions` integer, nullable, required
    - `ti_tv_ratio` number, nullable, required
    - `depth_record_count` integer, nullable, required
    - `median_depth` number, nullable
    - `depth_ge_20_count` integer, nullable
    - `pct_variant_records_ge_20x` number, nullable
    - `het_ab_record_count` integer, nullable
    - `het_ab_mean` number, nullable
    - `het_ab_median` number, nullable
    - `mean_depth` number, nullable, required
    - `depth_ge_10_count` integer, nullable, required
    - `pct_variant_records_ge_10x` number, nullable, required
    - `diploid_genotype_count` integer, nullable, required
    - `heterozygous_count` integer, nullable, required
    - `homozygous_alt_count` integer, nullable, required
    - `het_hom_alt_ratio` number, nullable, required
    - `filter_record_count` integer, nullable, required
    - `pass_filter_count` integer, nullable, required
    - `failed_filter_count` integer, nullable, required
    - `not_applied_filter_count` integer, nullable, required
    - `unknown_filter_count` integer, nullable, required
    - `pct_pass_filter` number, nullable, required
    - `computed_at` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-21** `9e02b69dff8c`: 6 info
  - added the optional property `metrics/anyOf[subschema #1: VariantQCMetrics]/depth_ge_20_count` to the response with the `200` status
  - added the optional property `metrics/anyOf[subschema #1: VariantQCMetrics]/het_ab_mean` to the response with the `200` status
  - added the optional property `metrics/anyOf[subschema #1: VariantQCMetrics]/het_ab_median` to the response with the `200` status
  - added the optional property `metrics/anyOf[subschema #1: VariantQCMetrics]/het_ab_record_count` to the response with the `200` status
  - …2 more

[Operation history](https://skmtc.dev/helena-bioinformatics/apis/helix-insight-variant-analysis-service/changes/sessions/:session_id/qc/variant-metrics/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)