---
title: "Resolve Gene"
method: POST
path: "/public/v1/genes/resolve"
tags: ["public-genes"]
---

# Resolve Gene

`POST /public/v1/genes/resolve`

## 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/genes/resolve`
- Auth: none declared

## Request body

- ResolveRequest
  - `query` string, required
  - `request_id` string, required

## Response `200`

Successful Response

- ResolveResponse
  - `schema_version` '1.0'
  - `request_id` string, required
  - `identity_snapshot_id` string, required
  - `status` 'exact' | 'alias' | 'ambiguous' | 'not_found' | 'withdrawn', required
  - `normalized_query` string, required
  - `candidates` Candidate[], required
    - `identity` GeneIdentity, required
      - `gene_id` string, required
      - `symbol` string, required
      - `name` string, required
      - `locus_type` string, required
      - `status` 'Approved' | 'Entry Withdrawn' | 'Merged/Split', required
      - `aliases` string[]
      - `previous_symbols` string[]
      - `ensembl_ids` string[]
      - `ncbi_gene_ids` string[]
      - `source_id` string, required
      - `replacement_gene_ids` string[]
    - `match_types` string[], required
    - `matched_terms` string[], required
  - `candidate_total` integer, required
  - `complete` true

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