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
- Open the node creator, select Duaer Data, then Variants.
- Words alone is enough (a new node starts with rs113488022). rs ID, Gene, and Variant ID are optional.
- 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
Search genes in Duaer
In Duaer, search genes with Duaer Data. One successful search uses 1 credit. Use the symbol with proteins.gene. This page includes the full English call skill.
Get startedSearch proteins in Duaer
In Duaer, search genes and proteins with Duaer Data. One successful search uses 1 credit. This page includes the full English call skill.
Get startedSearch diseases in Duaer
In Duaer, search UniProt disease names with Duaer Data. One successful search uses 1 credit. Use the formal name with proteins.disease. This page includes the full English call skill.
Get startedSearch pathways in Duaer
In Duaer, search Reactome pathways with Duaer Data. One successful search uses 1 credit. Use pathwayId with proteins.pathway. This page includes the full English call skill.