Skip to content

Weekly Full Bundles

Links: Monthly Full Bundles · Weekly Deltas · Parquet Files · How Releases Work

A weekly full bundle is published for every ClinVar weekly release. It has the same content and structure as a monthly full, built from that week's release, so the newest one is the current state with no replay. The weekly fulls live in v1/1.1/weekly/, the counterpart of NCBI's xml/weekly_release/:

v1/1.1/weekly/
  clinvar-gkm_00-latest_weekly.json.gz        newest weekly full (stable URL)
  clinvar-gkm_YYYY-MMDD.json.gz               one per weekly release of the CURRENT month
  clinvar-gkm_YYYY-MMDD.json.gz.sha256

Weekly fulls are kept for the current month only

When the first release of a new month is published, the previous month's weekly fulls are deleted, as NCBI deletes its weekly releases. The newest of them stays until the new month's official monthly is published (the monthly is normally a copy of it), and is deleted as soon as the monthly is up. They are a convenience copy, not the record: the official monthly that follows is built from the month's last release, and every past week can be rebuilt exactly from a monthly plus deltas. See Rebuild a past week. Don't hard-code a dated weekly URL in a script that runs after the month ends.

Download a weekly full with curl
# Newest weekly full (stable URL)
curl -O https://data.clinvar-gkm.org/v1/1.1/weekly/clinvar-gkm_00-latest_weekly.json.gz

# Or a specific week of the current month, with its checksum
curl -O https://data.clinvar-gkm.org/v1/1.1/weekly/clinvar-gkm_2026-1018.json.gz
curl -O https://data.clinvar-gkm.org/v1/1.1/weekly/clinvar-gkm_2026-1018.json.gz.sha256
sha256sum -c clinvar-gkm_2026-1018.json.gz.sha256      # macOS: shasum -a 256 -c

Monthly, weekly full, or monthly plus deltas?

  • The current state: the newest weekly full.
  • A fixed monthly snapshot that matches ClinVar's monthly release: the official monthly.
  • Keeping a local copy current without re-downloading a full bundle every week: the monthly plus the weekly deltas.