Variant Clinical Significance

curl -X POST https://win.oneshotagent.com/v1/tools/lookup/variant-clinical-significance \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "rsid": "rs80357906"
  }'

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"
  }),
});

const result = await agent.tool('lookup/variant-clinical-significance', {
  rsid: 'rs80357906'
});
console.log(result.data.result);
console.log(result.data.evidence);

{
  "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"
    }
  }
}

POST

tools

lookup

variant-clinical-significance

curl -X POST https://win.oneshotagent.com/v1/tools/lookup/variant-clinical-significance \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "rsid": "rs80357906"
  }'

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"
  }),
});

const result = await agent.tool('lookup/variant-clinical-significance', {
  rsid: 'rs80357906'
});
console.log(result.data.result);
console.log(result.data.evidence);

{
  "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"
    }
  }
}

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

string

ClinVar variation accession, for example VCV000017677 or VCV000017677.176; supply only vcv or rsid.

string

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.

string

Durable job ID for audit and lookup

string

Job status: completed

string

Always variant_clinical_significance

object

The answer, described under Result below

object

Where the answer came from and when

string

The public body the data comes from. Always US National Center for Biotechnology Information (ClinVar).

string

public when the data comes from a public body, commercial otherwise

string

When the lookup was made, as an ISO 8601 UTC time

string

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.

object[]

Up to five variations carrying the requested identifier.

string

Vcv.

string

Versioned ClinVar accession.

string

Title.

string

Variant type.

object[]

Genes.

string

Symbol.

string

Gene id.

string

Protein change. null when the source gives no value.

string[]

Molecular consequences.

string

Rsid. null when the source gives no value.

object

Germline. null when the source gives no value.

string

Classification.

string

Review status.

string

Last evaluated date, YYYY-MM-DD, or null.

object[]

Conditions.

string

Name.

object[]

Ids.

string

Source.

string

Id.

object

Somatic clinical impact. null when the source gives no value.

string

Classification.

string

Review status.

string

Last evaluated date, YYYY-MM-DD, or null.

object[]

Conditions.

string

Name.

object[]

Ids.

string

Source.

string

Id.

object

Oncogenicity. null when the source gives no value.

string

Classification.

string

Review status.

string

Last evaluated date, YYYY-MM-DD, or null.

object[]

Conditions.

string

Name.

object[]

Ids.

string

Source.

string

Id.

string

Page url.

curl -X POST https://win.oneshotagent.com/v1/tools/lookup/variant-clinical-significance \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "rsid": "rs80357906"
  }'

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"
  }),
});

const result = await agent.tool('lookup/variant-clinical-significance', {
  rsid: 'rs80357906'
});
console.log(result.data.result);
console.log(result.data.evidence);

{
  "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 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}

Overview

Compute

Data

Monitoring

Research & Enrich

Messaging

Web & Browser

Build

Commerce

Account & billing

Other

Variant Clinical Significance

Authentication

Request Body

Response (200 OK)

Result

Notes

​Authentication

​Request Body

​Response (200 OK)

​Result

​Notes

Authentication

Request Body

Response (200 OK)

Result

Notes