> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Variant Clinical Significance
> Look up the clinical significance reported for a variant in ClinVar by its variation accession or dbSNP rsID.
Reports what a public registry, ClinVar, says about one variant, for research; not medical advice. Classifications are submitters' and expert panels' interpretations. Supply exactly one ClinVar VCV accession or dbSNP rsID, never a person's genome, sequencing data or a VCF file. A versioned VCV identifies the base accession; the result reports the current accession version. An rsID can match several alleles: returns up to five matching variations. Includes germline, somatic clinical impact and oncogenicity classifications, review status, conditions and last evaluated dates. Empty classifications are null; no match returns an empty variants list. ClinVar refreshes weekly, and accession versions change when records change. NCBI places no restriction on use of ClinVar.
## Authentication
Requires x402 payment in the `payment-signature` header.
## Request Body
ClinVar variation accession, for example VCV000017677 or VCV000017677.176; supply only vcv or rsid.
dbSNP identifier, for example rs80357906; supply only rsid or vcv.
## Response (200 OK)
Top-level envelope: `success` (boolean) and `data` (object). All fields below are nested under `data`.
Durable job ID for audit and lookup
Job status: `completed`
Always `variant_clinical_significance`
The answer, described under Result below
Where the answer came from and when
The public body the data comes from. Always `US National Center for Biotechnology Information (ClinVar)`.
`public` when the data comes from a public body, `commercial` otherwise
When the lookup was made, as an ISO 8601 UTC time
Latest valid classification evaluation date (`last_evaluated`, YYYY-MM-DD) across germline, somatic clinical impact and oncogenicity classifications in all returned variants; `null` when none has a valid evaluation date.
## Result
Nested under `data.result`.
Up to five variations carrying the requested identifier.
Vcv.
Versioned ClinVar accession.
Title.
Variant type.
Genes.
Symbol.
Gene id.
Protein change. `null` when the source gives no value.
Molecular consequences.
Rsid. `null` when the source gives no value.
Germline. `null` when the source gives no value.
Classification.
Review status.
Last evaluated date, YYYY-MM-DD, or null.
Conditions.
Name.
Ids.
Source.
Id.
Somatic clinical impact. `null` when the source gives no value.
Classification.
Review status.
Last evaluated date, YYYY-MM-DD, or null.
Conditions.
Name.
Ids.
Source.
Id.
Oncogenicity. `null` when the source gives no value.
Classification.
Review status.
Last evaluated date, YYYY-MM-DD, or null.
Conditions.
Name.
Ids.
Source.
Id.
Page url.
```bash cURL theme={null}
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/variant-clinical-significance \
-H "Content-Type: application/json" \
-H "payment-signature: " \
-d '{
"rsid": "rs80357906"
}'
```
```javascript JavaScript theme={null}
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/variant-clinical-significance", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"rsid": "rs80357906"
}),
});
```
```typescript SDK theme={null}
const result = await agent.tool('lookup/variant-clinical-significance', {
rsid: 'rs80357906'
});
console.log(result.data.result);
console.log(result.data.evidence);
```
```json Response (200) theme={null}
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "variant_clinical_significance",
"result": {
"variants": [
{
"vcv": "VCV000017677",
"version": "VCV000017677.176",
"title": "NM_007294.4(BRCA1):c.5266dup (p.Gln1756fs)",
"variant_type": "Duplication",
"genes": [
{
"symbol": "BRCA1",
"gene_id": "672"
}
],
"protein_change": "Q1756fs, Q1777fs, Q652fs, Q1709fs",
"molecular_consequences": [
"frameshift variant",
"non-coding transcript variant"
],
"rsid": "rs80357906",
"germline": {
"classification": "Pathogenic",
"review_status": "reviewed by expert panel",
"last_evaluated": "2016-04-22",
"conditions": [
{
"name": "Breast-ovarian cancer, familial, susceptibility to, 1",
"ids": [
{
"source": "Orphanet",
"id": "145"
},
{
"source": "MedGen",
"id": "C2676676"
},
{
"source": "MONDO",
"id": "MONDO:0011450"
},
{
"source": "OMIM",
"id": "604370"
}
]
}
]
},
"somatic_clinical_impact": null,
"oncogenicity": null,
"page_url": "https://www.ncbi.nlm.nih.gov/clinvar/variation/17677/"
}
]
},
"evidence": {
"source": "US National Center for Biotechnology Information (ClinVar)",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"calls": [
{
"retrieved_at": "2026-01-15T12:00:00.000Z"
},
{
"retrieved_at": "2026-01-15T12:00:00.000Z"
}
],
"as_of": "2016-04-22"
}
}
}
```
See [Pricing](/pricing) for this tool's price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers `200`.
## Notes
* Results return inline. The finished job stays available at `/v1/requests/{request_id}`
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.