Gene Variants

curl -X POST https://win.oneshotagent.com/v1/tools/find/gene-variants \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "gene_id": "7157",
    "classification": "pathogenic",
    "expert_panel_only": true,
    "limit": 1
  }'

const response = await fetch("https://win.oneshotagent.com/v1/tools/find/gene-variants", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "payment-signature": paymentProof,
  },
  body: JSON.stringify({
    "gene_id": "7157",
    "classification": "pathogenic",
    "expert_panel_only": true,
    "limit": 1
  }),
});

const result = await agent.tool('find/gene-variants', {
  gene_id: '7157',
  classification: 'pathogenic',
  expert_panel_only: true,
  limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);

{
  "success": true,
  "data": {
    "request_id": "uuid",
    "receipt_id": "rcpt_...",
    "status": "completed",
    "tool": "gene_variants_find",
    "result": {
      "total": 49,
      "variants": [
        {
          "vcv": "VCV001759844",
          "version": "VCV001759844.14",
          "title": "NM_000546.6(TP53):c.761T>C (p.Ile254Thr)",
          "variant_type": "single nucleotide variant",
          "genes": [
            {
              "symbol": "TP53",
              "gene_id": "7157"
            }
          ],
          "protein_change": "I215T, I122T, I254T, I95T",
          "molecular_consequences": [
            "missense variant"
          ],
          "rsid": "rs1330865474",
          "germline": {
            "classification": "Pathogenic",
            "review_status": "reviewed by expert panel",
            "last_evaluated": "2026-01-06",
            "conditions": [
              "Li-Fraumeni syndrome"
            ]
          },
          "page_url": "https://www.ncbi.nlm.nih.gov/clinvar/variation/1759844/"
        }
      ]
    },
    "evidence": {
      "source": "US National Center for Biotechnology Information (ClinVar)",
      "source_kind": "public",
      "retrieved_at": "2026-10-18T12:00:00.000Z",
      "calls": [
        {
          "retrieved_at": "2026-10-18T12:00:00.000Z"
        },
        {
          "retrieved_at": "2026-10-18T12:00:00.000Z"
        }
      ],
      "as_of": "2026-01-06"
    }
  }
}

POST

tools

find

gene-variants

curl -X POST https://win.oneshotagent.com/v1/tools/find/gene-variants \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "gene_id": "7157",
    "classification": "pathogenic",
    "expert_panel_only": true,
    "limit": 1
  }'

const response = await fetch("https://win.oneshotagent.com/v1/tools/find/gene-variants", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "payment-signature": paymentProof,
  },
  body: JSON.stringify({
    "gene_id": "7157",
    "classification": "pathogenic",
    "expert_panel_only": true,
    "limit": 1
  }),
});

const result = await agent.tool('find/gene-variants', {
  gene_id: '7157',
  classification: 'pathogenic',
  expert_panel_only: true,
  limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);

{
  "success": true,
  "data": {
    "request_id": "uuid",
    "receipt_id": "rcpt_...",
    "status": "completed",
    "tool": "gene_variants_find",
    "result": {
      "total": 49,
      "variants": [
        {
          "vcv": "VCV001759844",
          "version": "VCV001759844.14",
          "title": "NM_000546.6(TP53):c.761T>C (p.Ile254Thr)",
          "variant_type": "single nucleotide variant",
          "genes": [
            {
              "symbol": "TP53",
              "gene_id": "7157"
            }
          ],
          "protein_change": "I215T, I122T, I254T, I95T",
          "molecular_consequences": [
            "missense variant"
          ],
          "rsid": "rs1330865474",
          "germline": {
            "classification": "Pathogenic",
            "review_status": "reviewed by expert panel",
            "last_evaluated": "2026-01-06",
            "conditions": [
              "Li-Fraumeni syndrome"
            ]
          },
          "page_url": "https://www.ncbi.nlm.nih.gov/clinvar/variation/1759844/"
        }
      ]
    },
    "evidence": {
      "source": "US National Center for Biotechnology Information (ClinVar)",
      "source_kind": "public",
      "retrieved_at": "2026-10-18T12:00:00.000Z",
      "calls": [
        {
          "retrieved_at": "2026-10-18T12:00:00.000Z"
        },
        {
          "retrieved_at": "2026-10-18T12:00:00.000Z"
        }
      ],
      "as_of": "2026-01-06"
    }
  }
}

Reports what a public registry, ClinVar, says about variants in a gene, for research; not medical advice. Classifications are submitters’ and expert panels’ interpretations. Supply exactly one NCBI Gene ID or official human gene symbol, never a person’s genome, sequencing data or a VCF file. Aliases do not match: use gene_resolve to resolve aliases first. Optionally filter by ClinVar classification properties and expert panel review; these properties can include combined classifications. By default, single_gene excludes large deletions and duplications spanning multiple genes; include_multi_gene includes them. Returns up to 20 variants in search order and the total ClinVar search count. Empty classifications are null; no match returns total 0 and an empty variants list. Each vcv can be passed to variant_clinical_significance for details, including somatic and oncogenicity classifications. ClinVar refreshes weekly; classifications carry their last evaluated dates. NCBI places no restriction on use of ClinVar.

Authentication

Requires x402 payment in the payment-signature header.

Request Body

string

NCBI Gene ID, for example 672; supply exactly one of gene_id or symbol. 1 to 12 characters.

string

Official human gene symbol, for example BRCA1; use gene_resolve for aliases. 1 to 30 characters.

string

ClinVar classification property filter; may include combined classifications. One of pathogenic, likely_pathogenic, uncertain, likely_benign, benign, conflicting.

boolean

Only variants reviewed by an expert panel. Defaults to false.

boolean

Include variants spanning multiple genes. Defaults to false.

integer

Maximum number of variants returned. From 1 to 20. Defaults to 10.

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 gene_variants_find

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

Newest valid germline classification last_evaluated date among the returned variants, or null when none is known.

Result

Nested under data.result.

integer

ClinVar search count, including matching records beyond the limit.

object[]

Variants.

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.

string[]

Conditions.

string

Page url.

curl -X POST https://win.oneshotagent.com/v1/tools/find/gene-variants \
  -H "Content-Type: application/json" \
  -H "payment-signature: <base64 x402 payment>" \
  -d '{
    "gene_id": "7157",
    "classification": "pathogenic",
    "expert_panel_only": true,
    "limit": 1
  }'

const response = await fetch("https://win.oneshotagent.com/v1/tools/find/gene-variants", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "payment-signature": paymentProof,
  },
  body: JSON.stringify({
    "gene_id": "7157",
    "classification": "pathogenic",
    "expert_panel_only": true,
    "limit": 1
  }),
});

const result = await agent.tool('find/gene-variants', {
  gene_id: '7157',
  classification: 'pathogenic',
  expert_panel_only: true,
  limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);

{
  "success": true,
  "data": {
    "request_id": "uuid",
    "receipt_id": "rcpt_...",
    "status": "completed",
    "tool": "gene_variants_find",
    "result": {
      "total": 49,
      "variants": [
        {
          "vcv": "VCV001759844",
          "version": "VCV001759844.14",
          "title": "NM_000546.6(TP53):c.761T>C (p.Ile254Thr)",
          "variant_type": "single nucleotide variant",
          "genes": [
            {
              "symbol": "TP53",
              "gene_id": "7157"
            }
          ],
          "protein_change": "I215T, I122T, I254T, I95T",
          "molecular_consequences": [
            "missense variant"
          ],
          "rsid": "rs1330865474",
          "germline": {
            "classification": "Pathogenic",
            "review_status": "reviewed by expert panel",
            "last_evaluated": "2026-01-06",
            "conditions": [
              "Li-Fraumeni syndrome"
            ]
          },
          "page_url": "https://www.ncbi.nlm.nih.gov/clinvar/variation/1759844/"
        }
      ]
    },
    "evidence": {
      "source": "US National Center for Biotechnology Information (ClinVar)",
      "source_kind": "public",
      "retrieved_at": "2026-10-18T12:00:00.000Z",
      "calls": [
        {
          "retrieved_at": "2026-10-18T12:00:00.000Z"
        },
        {
          "retrieved_at": "2026-10-18T12:00:00.000Z"
        }
      ],
      "as_of": "2026-01-06"
    }
  }
}

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

Authentication

Request Body

Response (200 OK)

Result

Notes

​Authentication

​Request Body

​Response (200 OK)

​Result

​Notes

Authentication

Request Body

Response (200 OK)

Result

Notes