# ClinVar · 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.

- Provider: Alexandria
- Category: Health
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `clinvar-ncbi-nlm-nih-gov/variants/search`
- Page: https://spiral.ai/tools/alexandria/clinvar-ncbi-nlm-nih-gov/variants/search

## Pricing

$0.00873 per call.

## Limits

- 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

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `gene` | text |  | — | HGNC gene symbol, e.g. `BRCA1`. A symbol ClinVar does not know gives an empty page. |
| `limit` | number | 1 to 50 | 10 | Results per page. |
| `query` | text |  | — | 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. |
| `offset` | number | 0 to 50000 | 0 | Zero-based index of the first result; pass `next_offset` for the next page. |
| `condition` | text |  | — | 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_stars` | number | 0 to 4 | — | Only variants whose aggregate review status earns at least this many stars (2 = multiple submitters without conflicts or better). |
| `variant_type` | one 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_status` | list |  | — | 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. |
| `classification` | one 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_consequence` | one 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. |

## Example

```bash
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>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=clinvar-ncbi-nlm-nih-gov%2Fvariants%2Fsearch

## Common questions

### ClinVar · Search

**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.

