Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaHealthAvailable now

ClinVar · Search

clinvar-ncbi-nlm-nih-gov/variants/search

Get health and medical data with ClinVar · Search from Alexandria through one Spiral API key. To find ClinVar variants and how they are classified: the pathogenic variants in a gene, those reviewed by an expert panel, ClinVar's records for an rsID or HGVS name, or the variants reported for a disease. For one variant's submitter-level evidence use get. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

$0.00873 per call.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
genetext—

HGNC gene symbol, e.g. BRCA1. A symbol ClinVar does not know gives an empty page.

limitnumber
1 to 50
10

Results per page.

querytext—

A variant reference (BRCA1 c.181T>G, NM_007294.4:c.181T>G, rs28897672, NC_000017.11:43106486:A:C, VCV000017661, RCV000019229, CA001182) or free text with Entrez ClinVar fields and AND, OR, NOT (BRCA2[gene] AND founder). An HGVS name must match ClinVar's transcript version.

offsetnumber
0 to 50000
0

Zero-based index of the first result; pass next_offset for the next page.

conditiontext—

Disease or phenotype name (hereditary breast ovarian cancer), or an ID: MedGen CUI (C2676676), OMIM (OMIM:604370), MONDO (MONDO:0011450), Orphanet (ORPHA:145) or HPO (HP:0003002).

min_starsnumber
0 to 4
—

Only variants whose aggregate review status earns at least this many stars (2 = multiple submitters without conflicts or better).

variant_typeone of
single nucleotide variant, Deletion, Duplication, Insertion, Indel, Microsatellite, Inversion, Tandem duplication, copy number gain, copy number loss, Translocation, fusion, Complex, protein only, Variation, CompoundHeterozygote, Diplotype, Distinct chromosomes
—

ClinVar variant type.

review_statuslist—

Aggregate review status, any of these. ClinVar's star ratings: practice guideline 4; expert panel 3; multiple submitters, no conflicts 2; single submitter or conflicting 1; the rest 0.

classificationone of
pathogenic, likely_pathogenic, pathogenic_or_likely_pathogenic, uncertain_significance, likely_benign, benign, benign_or_likely_benign, conflicting
—

Aggregate germline classification. pathogenic also matches records aggregated as Pathogenic/Likely pathogenic; pathogenic_or_likely_pathogenic matches either; conflicting is Conflicting classifications of pathogenicity.

molecular_consequenceone of
missense variant, nonsense, frameshift variant, synonymous variant, splice donor variant, splice acceptor variant, intron variant, 5 prime UTR variant, 3 prime UTR variant, inframe deletion, inframe insertion, inframe indel, initiator codon variant, stop lost, non-coding transcript variant, genic upstream transcript variant, genic downstream transcript variant, no sequence alteration
—

Molecular consequence on any transcript.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "clinvar-ncbi-nlm-nih-gov/variants/search",
    "input": {
      "gene": "<gene>"
    }
  }'

Frequently asked questions

How much does ClinVar · Search cost?

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use ClinVar · Search through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "clinvar-ncbi-nlm-nih-gov/variants/search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use ClinVar · Search?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use ClinVar · Search?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.