---
title: "Get carrier status findings"
method: GET
path: "/sessions/{session_id}/carriers"
tags: ["Carrier Status"]
---

# Get carrier status findings

`GET /sessions/{session_id}/carriers`

## 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}/carriers`
- Auth: none declared

Return healthy carrier findings for a session.

    Carrier types:
    - AR_CARRIER: Heterozygous P/LP in autosomal recessive gene (not compound het)
    - XL_CARRIER: Female heterozygous P/LP in X-linked recessive gene

    Results are pre-computed by Stage 6 (Reproductive Risk Annotation)
    in the variant analysis pipeline. This endpoint reads from DuckDB.

    Use force=true to re-run detection.

## Path parameters

- `session_id` string, uuid, required

## Query parameters

- `force` boolean: Force re-run of carrier detection

## Response `200`

Successful Response

- CarrierResponseSchema: Response with carrier findings.
  - `session_id` string, uuid, required
  - `total_carriers` integer, required
  - `ar_carrier_count` integer, required
  - `xl_carrier_count` integer, required
  - `carriers` CarrierResultSchema[], required
    - `variant_idx` integer, required
    - `gene_symbol` string, required
    - `carrier_type` string, required: AR_CARRIER or XL_CARRIER
    - `inheritance_mode` string, nullable
    - `disease_name` string, nullable
    - `clinical_note` string, required
    - `confidence` string, required: HIGH or MODERATE
    - `acmg_class` string, nullable
    - `chromosome` string, nullable
    - `position` integer, nullable
    - `genotype` string, nullable
    - `hgvs_protein` string, nullable
    - `transcript_id` string, nullable
    - `transcript_representations` object, nullable
    - `hgvs_cdna` string, nullable
    - `rsid` string, nullable
    - `global_af` number, nullable
    - `review_stars` integer, nullable

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