Duaer

Get started

Search variants in Duaer

In Duaer, search variants with Duaer Data (ClinVar / dbSNP). One successful search uses 1 credit. This page includes the full English call skill.

What you get

Variants in Duaer data searches public ClinVar / dbSNP records. One successful search uses 1 credit.

Add the node from the Duaer Data category (Variants). Look up gene symbols with Genes.

Search on the canvas

  1. Open the node creator, select Duaer Data, then Variants.
  2. Words alone is enough (a new node starts with rs113488022). rs ID, Gene, and Variant ID are optional.
  3. Limit defaults to 10, max 20. Select Execute step.

A successful search uses 1 credit. Production deliverables land in the data pool.

Call the API

  • GET https://api.duaer.com/v1/data/variants?...
  • Authorization: Bearer <Duaer key>
  • Fields combine; at least one search field is required.

For keys, refer to Authentication for the Duaer public API. Below is the English call skill.

Call skill

The skill for calling this data. Keep it English.

---
name: duaer-variants
description: >-
  Duaer variants. ClinVar and dbSNP variants from MyVariant.info by rs id, gene symbol, words, or HGVS id, with clinical significance and alleles.
  One successful search uses 1 Duaer credit.
---

# Duaer variants

Duaer variants searches MyVariant.info, which merges ClinVar and dbSNP. It uses one search field: `id` first, then `rsid`, then `gene`, then `q`.

## When to use

- Check the clinical significance of an rs id.
- List ClinVar variants in a gene.
- Get the reference and alternate allele of a variant.

## When not to use

- Population allele frequencies. Use https://skills.duaer.com/gnomad.md.
- Variant effect prediction. Use https://skills.duaer.com/ensembl-vep.md.
- Trait associations from GWAS. Use https://skills.duaer.com/gwas.md.

## Call

`GET https://api.duaer.com/v1/data/variants?rsid=rs113488022`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `q`, `rsid`, `gene`, or `id`. When you send more than one, Duaer uses `id`, else `rsid`, else `gene`, else `q`.

- `q` — Words, such as an rs id.
- `rsid` — dbSNP rs id, such as `rs113488022`. A number without `rs` also works.
- `gene` — Gene symbol with ClinVar records, such as `BRAF`. Look up symbols with https://skills.duaer.com/genes.md.
- `id` — HGVS genomic id, such as `chr7:g.140453136A>T`. Reuse `variantId` from a result for an exact lookup.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/variants?rsid=rs113488022` — BRAF V600E by rs id.
- `GET https://api.duaer.com/v1/data/variants?gene=BRCA1&limit=20` — ClinVar variants in BRCA1.
- `GET https://api.duaer.com/v1/data/variants?id=chr7:g.140453136A%3ET` — one variant by HGVS id.

## Result

The response is `{ "items": [...] }`. Each item has `source` (`MyVariant`), `title`, `url`, and `summary`, plus:

- `variantId` — HGVS genomic id.
- `rsid` — dbSNP rs id.
- `gene` — gene symbol.
- `hgvsProtein` — protein change, such as `p.Val600Glu`.
- `clinicalSignificance` — ClinVar significance, such as `Pathogenic`.
- `chrom`, `ref`, `alt` — chromosome and alleles.

Fields without a value are empty strings.

## Credits

A successful search uses 1 credit, even when it finds nothing.
Wrong input or a missing search field returns 400 with a message and uses 0.
A failed upstream search returns 503 and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/genes.md — Duaer genes
- https://skills.duaer.com/diseases.md — Duaer diseases
- https://skills.duaer.com/proteins.md — Duaer proteins
- https://skills.duaer.com/life-research-brief.md — Digital employee: Life research brief

Questions

Where do I reuse a variant from Duaer?

Put the item variantId into the Variants Variant ID field in Duaer for an exact lookup.

In this section