---
title: "Read a bounded public GRCh38 and MANE reference window"
method: GET
path: "/public/v1/variants/reference"
tags: ["public-variants"]
---

# Read a bounded public GRCh38 and MANE reference window

`GET /public/v1/variants/reference`

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

## Query parameters

- `chrom` string, required
- `start` integer, required
- `end` integer, required

## Response `200`

Successful Response

- PublicReferenceResponse
  - `chrom` string, required
  - `start` integer, required
  - `end` integer, required
  - `sequence` string, required
  - `transcript` PublicReferenceTranscript, required
    - `geneSymbol` string, required
    - `transcriptId` string, required
    - `proteinId` string, nullable, required
    - `strand` '+' | '-', required
    - `exons` array[], required
      - unknown[]
        - unknown
    - `cds` array[], required
      - unknown[]
        - unknown
    - `codons` PublicReferenceCodon[], required
      - `bases` string, required
      - `aminoAcid` string, required
      - `proteinPosition` integer, required
      - `genomicPositions` integer[], required

## Other responses

- `422`: Invalid reference window
- `429`: Anonymous request limit reached
- `503`: Reference assets unavailable
- `504`: Reference read timed out

---

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