What it returns
Every month-over-month change in ClinVar since February 2025, as JSON: which variants moved from uncertain significance to likely pathogenic, which pathogenic calls became conflicting, which were downgraded to benign, and which gained a stronger review status. Each row carries the previous and current classification, so you can re-check past reports against the latest evidence for any gene.
Built from NCBI's monthly ClinVar variant_summary releases (public domain), diffed release to release, GRCh38 coordinates. Updated weekly; a new month appears after NCBI publishes it.
- Variant: ClinVar VariationID and link, gene, HGVS name, variant type, chromosome, start and stop, conditions.
- Classification now and before: the full text, a tier (P, P/LP, LP, VUS, conflicting, LB, B/LB, B, other), and modifiers such as
risk factororlow penetrancekept apart from the tier. - Change type:
reclassified(moved between pathogenic, VUS, conflicting and benign),refined(inside one family, such as P to P/LP),relabeled(wording or modifiers only),review-status,new,removed. - Direction:
up(toward pathogenic) ordown(toward benign). - Evidence: review status before and after, submitter count, date last evaluated,
newEvaluation(a submitter evaluated it since the previous release) andsubmitterAdded(the submitter count grew). When both are false the change came from ClinVar re-aggregating older submissions.
Common uses
- Re-contacting: list every variant in your genes that moved from VUS to likely pathogenic or pathogenic since a given month.
- Monitoring a gene panel for downgrades and new conflicts.
- Research on reclassification rates by gene, variant type or review status.
Request
POST https://api.pushbuild.com/clinvar-reclassifications/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
genes | string | Comma-separated HGNC symbols. |
variationIds | string | Comma-separated ClinVar VariationIDs. |
change | string | reclassified (default: moved between pathogenic, VUS, conflicting and benign), refined (inside one family, e.g. P to P/LP or B to LB), relabeled (same tier, wording or modifiers only), review-status, new, removed; comma-separated. |
fromTier | string | Previous tier: P, P/LP, LP, VUS, conflicting, LB, B/LB, B, other. |
toTier | string | Current tier: P, P/LP, LP, VUS, conflicting, LB, B/LB, B, other. |
direction | string | up (toward pathogenic) or down (toward benign). |
allGenes | boolean | Search every gene; needed when no gene, ID or tier filter is given. Default: false. |
sinceMonth | string | YYYY-MM, earliest release month (data starts 2025-02). |
untilMonth | string | YYYY-MM, latest release month. |
offset | integer | Skip this many results (paging). Default: 0. |
requireNewEvaluation | boolean | Only changes backed by new evidence: a submitter was added, or a submitter evaluated the variant since the previous release (drops changes caused by ClinVar re-aggregating older submissions). Default: false. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/clinvar-reclassifications/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"genes": "BRCA1,TANC2", "change": "reclassified", "maxItems": 20}'
Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}
Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.08 per 1,000 rows. No charge for errors or empty searches.
Related APIs
ClinGen Dosage Sensitivity Changes Feed API
Daily change log of ClinGen dosage sensitivity curations since 2022: new, changed and removed gene and region curations with haploinsufficiency and triplosensitivity scores, previous values, the fields that changed, disease, PMIDs and GRCh38 location.
Gene-Disease Validity API
Every gene-disease validity assertion in GenCC (ClinGen, Labcorp/Invitae, Ambry, Orphanet, G2P, PanelApp and more): classification from Definitive to Refuted, inheritance, MONDO disease, submitter, date, PMIDs and report links, with ClinGen expert panel and SOP.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com