---
title: "One variant by rsID"
method: GET
path: "/variants/{rsid}"
tags: ["knowledge"]
---

# One variant by rsID

`GET /variants/{rsid}`

## Request

- Base URL: `https://deepdna.ai/api/v1`
- URL: `https://deepdna.ai/api/v1/variants/{rsid}`
- Auth: none declared

## Path parameters

- `rsid` string, required

## Response `200`

Variant

- object
  - `variant` Variant
    - `rsid` string, required
    - `gene` string, required
    - `name` string, nullable
    - `alleles` string, nullable
    - `effect` string, nullable
    - `reading` Reading: How to read this position in a raw DNA file, checked against dbSNP and Ensembl. DeepDNA's tools take no genotype: compare a user's file with these alleles in the agent or app, outside DeepDNA.
      - `assembly` 'GRCh37', required
      - `chromosome` string, required
      - `position` integer, required
      - `reference_allele` string, nullable, required: Plus strand of GRCh37, as 23andMe raw data reports it; check the orientation of other providers' files. Null for insertions and deletions.
      - `variant_allele` string, nullable, required: Plus-strand allele the record's effect refers to. Null for insertions and deletions.
      - `gene_strand` 'plus' | 'minus', required
      - `countable` boolean, required: True when copies of variant_allele at this one position can be counted from a raw file and that allele is, on its own, the variant the record describes. False for a haplotype-only position, an allele that common star alleles of different function share (as at rs1065852, carried by both *4 and *10), and insertions or deletions. Rarer alleles can share a countable allele, so a count is of the allele only: not a star-allele call, an isoform or a metabolizer status, and not a judgement on how reliable a chip call is. On chromosome X, males carry one copy, so counting needs the person's sex.
      - `strand_ambiguous` boolean, required: A/T or C/G: the letters are the same on both strands, so you can't tell which strand a file uses, and a homozygote on the other strand reads as the other allele. Count it only when the file is known to be on the plus strand of GRCh37.
      - `sources` Source[], required
        - `label` string, required
        - `url` string, uri, nullable: null for a literature citation given by author/journal/year
    - `sources` Source[]
      - `label` string, required
      - `url` string, uri, nullable: null for a literature citation given by author/journal/year
  - `gene` GeneRef
    - `symbol` string
    - `name` string, nullable
    - `url` string, uri
  - `meta` Meta
    - `disclaimer` string
    - `api_version` string
    - `docs` string, uri
    - `status` string

## Other responses

- `404`: Not in the knowledge base

---

[API](https://skmtc.dev/deepdna/apis/deepdna-api.md) · [All operations](https://skmtc.dev/deepdna/apis/deepdna-api/llms.txt) · [OpenAPI document](https://skmtc.dev/deepdna/apis/deepdna-api/revisions/e33e002594ea?raw)